extractr docs
Vinted

Get a listing

GET
/vinted/get_listing

Full detail for one Vinted item: description, asking price with the buyer-protection and postage breakdown, brand, size, condition, colour and every other attribute the seller filled in, category, reserved/hidden flags, the complete photo set, and the seller's profile with feedback count and rating. Takes the item id returned by search — or paste any vinted.* item URL. Anonymous; no Vinted account needed.

Costs 2 credits per request.

Authorization

ApiKeyAuth
X-API-Key<token>

API key created in the extractr dashboard (ext_live_...). Also accepted as Authorization: Bearer.

In: header

Query Parameters

listing_id*string

Vinted item id, or a full vinted.* item URL to extract it from.

Length1 <= length <= 300
marketplace?string

Vinted site to use. One of: uk, us, fr, de, es, it, nl, be, at, pt, ie, lu, lt, sk, fi, gr, hr, pl, cz, hu, ro, se, dk.

Default"uk"

Value in

  • "uk"
  • "us"
  • "fr"
  • "de"
  • "es"
  • "it"
  • "nl"
  • "be"
  • "at"
  • "pt"
  • "ie"
  • "lu"
  • "lt"
  • "sk"
  • "fi"
  • "gr"
  • "hr"
  • "pl"
  • "cz"
  • "hu"
  • "ro"
  • "se"
  • "dk"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/vinted/get_listing?listing_id=10060648906"
{  "listing_id": "10060648906",  "title": "Baker by Ted Baker Blue/Chocolate Brown Stripe Beanie and Mittens Set",  "url": "https://www.vinted.co.uk/items/10060648906",  "description": "Brand new with tags.\n\nBoys Baker by Ted Baker set. Size 3-4 years.",  "price": 11.95,  "currency": "GBP",  "total_price": 13.21,  "buyer_protection_fee": 1.26,  "shipping_price": 2.29,  "free_shipping": false,  "pickup_only": false,  "brand": "Ted Baker",  "brand_id": "1219",  "size": "3-5 years, 21 inches",  "condition": "New with tags",  "colour": "Brown, Navy",  "uploaded": "16 min ago",  "details": [    {      "code": "size_text",      "label": "Size",      "value": "3-5 years, 21 inches"    }  ],  "category_id": "1749",  "category_path": [    "Kids",    "Boys clothing",    "Accessories",    "Caps & hats"  ],  "is_reserved": false,  "is_hidden": false,  "favourite_count": 18,  "images": [    "string"  ],  "seller": {    "id": "145742200",    "username": "gazm7",    "is_business": false,    "feedback_count": 652,    "feedback_reputation": 1,    "photo": "string",    "last_seen": "Last seen an hour ago",    "badges": [      "ACTIVE_LISTER",      "SPEEDY_SHIPPING"    ]  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked."  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked."  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked."  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked."  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked."  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked."  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked."  }}