# Vinted User Info

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/vinted/user/info` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/vinted-user-info |

## Description

Retrieve public Vinted seller profile by member URL or user ID. Returns the raw `/api/v2/users/{id}` object: login, photo, feedback stats, followers, verification, bundle discounts, and listing counts.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/vinted/user/info' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Italian seller on vinted.fr (fiorediottobre7)

```json
{
  "id": 272737992,
  "city": "",
  "path": "/member/272737992-fiorediottobre7",
  "about": "Vendo articoli in ottimo stato per liberare spazio e dargli una seconda vita 🩷\n\nNON ACCETTO RESI ma sono disponibile a fornire tutte le misure e dettagli dei capi prima dell'acquisto 🤗",
  "email": null,
  "login": "fiorediottobre7",
  "photo": {
    "id": 246663068,
    "url": "https://images1.vinted.net/t/01_0261e_RfD5M3mu4vbrTuNyhdvBT9A3/f800/1748634598.jpeg?s=08b7869a7ee3ff4e9524d5186cadf7f998a2714f",
    "extra": {},
    "width": 96,
    "height": 96,
    "is_hidden": false,
    "temp_uuid": null,
    "thumbnails": [
      {
        "url": "https://images1.vinted.net/t/01_0261e_RfD5M3mu4vbrTuNyhdvBT9A3/310x310/1748634598.jpeg?s=0c82ba018430138790cc09c79b96d7282a16429a",
        "type": "thumb310",
        "width": 310,
        "height": 310,
        "original_size": null
      },
      {
        "url": "https://images1.vinted.net/t/01_0261e_RfD5M3mu4vbrTuNyhdvBT9A3/150x150/1748634598.jpeg?s=cd48303033433342956042fd45c00f6cd074d9ea",
        "type": "thumb150",
        "width": 150,
        "height": 150,
        "original_size": null
      }
    ],
    "orientation": null,
    "full_size_url": "https://images1.vinted.net/tc/01_0261e_RfD5M3mu4vbrTuNyhdvBT9A3/1748634598.jpeg?s=ae1dd2e99a114d311eca7d54acc347bdfb198f40",
    "is_suspicious": false,
    "dominant_color": "#31abc2",
    "high_resolution": {
      "id": "01_0261e_RfD5M3mu4vbrTuNyhdvBT9A3",
      "timestamp": 1748634598,
      "orientation": null
    },
    "dominant_color_opaque": "#C1E6ED"
  },
  "locale": "it-fr",
  "anon_id": "9c8cb2ee-2b7d-4390-88ca-7e9d23360a93",
  "city_id": null,
  "birthday": null,
  "business": false,
  "contacts": null,
  "currency": "EUR",
  "is_hated": false,
  "hates_you": false,
  "is_online": false,
  "moderator": false,
  "real_name": null,
  "can_bundle": true,
  "country_id": 18,
  "fundraiser": {
    "id": null,
    "active": false,
    "currency": "EUR",
    "percentage": 0,
    "feature_disabled": false
  },
  "item_count": 117,
  "updated_on": 1757843003,
  "profile_url": "https://www.vinted.fr/member/272737992-fiorediottobre7",
  "country_code": "IT",
  "is_favourite": false,
  "localization": "none",
  "verification": {
    "email": {
      "valid": true,
      "available": true
    },
    "google": {
      "valid": true,
      "available": true,
      "verified_at": "2025-05-30T21:49:58+02:00"
    },
    "facebook": {
      "valid": false,
      "available": true,
      "verified_at": null
    }
  },
  "country_title": "Italie",
  "hide_feedback": false,
  "is_on_holiday": false,
  "last_loged_on": "aujourd'hui 16 h 53",
  "account_status": 0,
  "feedback_count": 250,
  "bundle_discount": {
    "id": 39006917,
    "enabled": true,
    "user_id": 272737992,
    "fraction": "0.1",
    "discounts": [
      {
        "fraction": "0.1",
        "minimal_item_count": 2
      },
      {
        "fraction": "0.15",
        "minimal_item_count": 3
      },
      {
        "fraction": "0.2",
        "minimal_item_count": 5
      }
    ],
    "minimal_item_count": 2
  },
  "default_address": null,
  "expose_location": false,
  "followers_count": 266,
  "following_count": 0,
  "iso_locale_code": "it-IT",
  "account_ban_date": null,
  "business_account": null,
  "can_view_profile": true,
  "country_iso_code": "IT",
  "facebook_user_id": null,
  "given_item_count": 262,
  "last_loged_on_ts": "2026-07-19T16:53:41+02:00",
  "taken_item_count": 5,
  "avg_response_time": null,
  "is_account_banned": false,
  "share_profile_url": "https://www.vinted.fr/member/272737992-fiorediottobre7",
  "total_items_count": 379,
  "action_restriction": null,
  "msg_template_count": 0,
  "business_account_id": null,
  "contacts_permission": null,
  "country_title_local": "Italie",
  "feedback_reputation": 1,
  "is_catalog_moderator": false,
  "location_description": null,
  "third_party_tracking": false,
  "allow_direct_messaging": true,
  "following_brands_count": 0,
  "neutral_feedback_count": 1,
  "negative_feedback_count": 1,
  "positive_feedback_count": 248,
  "is_publish_photos_agreed": true,
  "is_bpf_price_prominence_applied": false,
  "is_catalog_role_marketing_photos": false
}
```

## Documentation

## Overview
Retrieve the public Vinted seller profile for a member. Pass a profile URL, a direct Vinted API user URL, or a numeric user ID.

Piloterr calls the internal Vinted API (`/api/v2/users/{id}`) with an auto-managed session cookie and returns the **raw user object** as Vinted exposes it (same schema as Search seller snapshots, but with the full profile payload).

Costs **1 credit** per call.

## Workflow
Typical flow on Piloterr:
1. **[Vinted Search](/v2/vinted/search)** to find listings
2. **[Vinted Item](/v2/vinted/item)** for listing details (includes an optional seller snapshot)
3. **User Info** (this endpoint) when you only have a member ID/URL or need the full profile

## Quickstart
```
GET https://api.piloterr.com/v2/vinted/user/info?query=https://www.vinted.fr/member/272737992-fiorediottobre7
GET https://api.piloterr.com/v2/vinted/user/info?query=272737992
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Member profile URL, `/api/v2/users/{id}` URL, or numeric user ID |

## Response fields
| Field | Description |
|---|---|
| `id` | Numeric Vinted user ID |
| `login` | Username |
| `path` | Member path slug (`/member/{id}-{login}`) |
| `profile_url` / `share_profile_url` | Canonical profile URLs on the Vinted domain |
| `about` | Seller bio when public |
| `photo` | Avatar with `url`, `thumbnails[]`, `full_size_url` |
| `country_code` / `country_iso_code` | Seller country (`IT`, `FR`, …) |
| `country_title` | Localized country label |
| `city` | City when exposed |
| `currency` | Seller currency (`EUR`, …) |
| `item_count` | Active listings |
| `total_items_count` | Lifetime listed items |
| `given_item_count` / `taken_item_count` | Sold / bought counts |
| `followers_count` / `following_count` | Social counts |
| `feedback_count` | Total reviews |
| `positive_feedback_count` / `negative_feedback_count` / `neutral_feedback_count` | Review breakdown |
| `feedback_reputation` | Reputation score |
| `verification` | Email, Google, Facebook verification flags |
| `bundle_discount` | Multi-item discount tiers when enabled |
| `business` | Whether this is a business account |
| `last_loged_on` / `last_loged_on_ts` | Last activity (localized string + ISO timestamp) |
| `is_online` / `is_on_holiday` | Availability flags |

## Error codes
| Code | Cause |
|---|---|
| `404` | Empty `query`, ID not found in URL, or member does not exist |
| `403` | Access blocked (anti-bot, session rejected) |

## Good to know
- Works on any `vinted.*` domain present in the URL; a seller registered in Italy can still be fetched via `vinted.fr`.
- Session cookies are handled automatically (same as Search and Item).
- Unlike **[Vinted Item](/v2/vinted/item)**, this endpoint does **not** normalize keys, you get Vinted's native snake_case schema.
- Public profile data only; email and private contact fields are not exposed.

## Main use cases
- Enrich resale leads with verified seller profiles and review stats
- Filter trusted sellers by verification status or feedback reputation
- Monitor key Vinted sellers and their listing activity for competitive research