Piloterr

Vinted Item

Fetch a Vinted listing by item URL or numeric ID. Parses the public item page (Next.js payload), returns a normalized snake_case object with photos, attributes, shipping, pricing, and optional seller profile.

Credit cost: 1 credit per call

GET
/v2/vinted/item

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Vinted item URL or numeric item ID.

Examples (URL — recommended):

https://www.vinted.com/items/9437210920-purple-prom-dress

Example (ID only):

9437210920

Notes:

  • Domain is inferred from the URL (vinted.fr, vinted.com, …).
  • With a bare numeric ID, Piloterr tries the main Vinted domains until the item is found.
  • Use region to force a domain and skip the multi-domain lookup.
region?string

Force the Vinted domain when query is a bare item ID only.

Examples:

com
https://www.vinted.com
https://www.vinted.de

Notes:

  • Ignored when query is a full item URL.
  • Speeds up lookups when you already know the marketplace.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/vinted/item?query=string"
{
  "id": 9437210920,
  "url": "https://www.vinted.com/items/9437210920-purple-prom-dress",
  "user": {
    "id": 3163220665,
    "city": "CHAMBERSBURG, PA",
    "login": "gingertastic88",
    "photo": {
      "id": 317632205,
      "url": "https://images1.vinted.net/t/01_00734_TjeYgCPBFTM9wAukJhk91fHm/f800/1781705165.webp?s=996d52a34c31e60e6cad8c3ad1d0bd504928d6e8",
      "width": 96,
      "height": 96
    },
    "business": false,
    "item_count": 10,
    "profile_url": "https://www.vinted.com/member/3163220665-gingertastic88",
    "country_code": "US",
    "verification": {
      "email": {
        "valid": true,
        "available": true
      },
      "google": {
        "valid": true,
        "available": true,
        "verified_at": "2026-06-17T08:06:05-06:00"
      }
    },
    "country_title": "United States",
    "feedback_count": 1,
    "feedback_reputation": 1,
    "positive_feedback_count": 1
  },
  "color": "Purple",
  "price": {
    "amount": "9.0",
    "currency_code": "USD"
  },
  "title": "Purple prom dress",
  "photos": [
    {
      "id": 39947998424,
      "url": "https://images1.vinted.net/t/03_01b9c_waHhWwt2YUWWt6mHUEY8DPbs/f800/1784471551.webp?s=895a7ec5100a7bc29e98d171869c4c1ab510ac13",
      "width": 600,
      "height": 800,
      "is_main": true,
      "full_size_url": "https://images1.vinted.net/tc/03_01b9c_waHhWwt2YUWWt6mHUEY8DPbs/1784471551.webp?s=e1d11e587899e731615fee24ed0c6cd41d6ab0fe"
    }
  ],
  "status": "New without tags",
  "can_buy": true,
  "plugins": {
    "favourite": {
      "seller_id": 3163220665,
      "is_favourite": false,
      "favourite_count": 0
    },
    "breadcrumbs": {
      "brand_id": 1,
      "catalog_id": 1777,
      "breadcrumbs": [
        {
          "url": "/catalog/1904-women",
          "title": "Women"
        },
        {
          "url": "/catalog/4-clothing",
          "title": "Clothing"
        },
        {
          "url": "/catalog/10-dresses",
          "title": "Dresses"
        },
        {
          "url": "/catalog/1774-special-occasion-dresses",
          "title": "Special-occasion dresses"
        },
        {
          "url": "/catalog/1777-prom-dresses",
          "title": "Prom dresses"
        }
      ]
    },
    "description": {
      "description": "Long purple prom dress, one strap"
    },
    "item_status": {
      "is_draft": false,
      "promoted": true,
      "is_closed": false,
      "is_hidden": false,
      "is_reserved": false,
      "transaction_permitted": true
    }
  },
  "brand_id": 1,
  "category": "Women Prom dresses",
  "promoted": true,
  "seller_id": 3163220665,
  "attributes": {
    "size": {
      "id": 506,
      "value": "S / US 4-6"
    },
    "color": "Purple",
    "status": {
      "id": 50,
      "value": "New without tags"
    },
    "upload_date": "an hour ago"
  },
  "catalog_id": 1777,
  "size_title": "S / US 4-6",
  "description": "Long purple prom dress, one strap",
  "instant_buy": true,
  "uploaded_at": "an hour ago",
  "is_favourite": false,
  "favourite_count": 0,
  "pricing_services": {
    "services": {
      "shipping": {
        "type": "shipping",
        "is_free": true,
        "final_price": {
          "amount": "0",
          "currency_code": "USD"
        },
        "original_price": {
          "amount": "6.69",
          "currency_code": "USD"
        }
      },
      "buyer_protection": {
        "type": "buyer_protection",
        "is_free": false,
        "final_price": {
          "amount": "1.15",
          "currency_code": "USD"
        },
        "original_price": {
          "amount": "1.15",
          "currency_code": "USD"
        }
      }
    },
    "total_amount": {
      "amount": "10.15",
      "currency_code": "USD"
    },
    "original_asking_amount": {
      "amount": "9",
      "currency_code": "USD"
    }
  },
  "shipping_details": {
    "price": {
      "amount": "0",
      "currency_code": "USD"
    },
    "discount": null,
    "is_pickup_only": false,
    "is_free_shipping": true,
    "are_multiple_shipping_options_available": false
  }
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}