Vinted

Vinted Product API

One Vinted listing by item id or URL, on any of 27 country sites: title, description, price and currency (the seller's currency, which can differ from the country site's), brand, size, condition, color, material, when it was uploaded as Vinted words it (uploaded_relative, e.g. "4 days ago"), category id and path, all photos, favourite count, reserved and sold state, whether it can be bought now, and the seller (id, login, profile URL, business flag, feedback count, rating 0-1, badges). Sold listings still return their last price. An unknown id is a 404. Costs 1 credit per request.

POST/api/v1/vinted/product

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

countryenum<string>default:fr

The Vinted country site the item_id is looked up on. Ignored when url is given: the URL's own site is used and echoed as country.

Example: uk

fr — France (vinted.fr), EUR. The default.
be — Belgium (vinted.be), EUR.
lu — Luxembourg (vinted.lu), EUR.
es — Spain (vinted.es), EUR.
nl — Netherlands (vinted.nl), EUR.
lt — Lithuania (vinted.lt), EUR.
de — Germany (vinted.de), EUR.
at — Austria (vinted.at), EUR.
it — Italy (vinted.it), EUR.
uk — United Kingdom (vinted.co.uk), GBP.
pt — Portugal (vinted.pt), EUR.
us — United States (vinted.com), USD.
cz — Czech Republic (vinted.cz), CZK.
sk — Slovakia (vinted.sk), EUR.
pl — Poland (vinted.pl), PLN.
se — Sweden (vinted.se), SEK.
ro — Romania (vinted.ro), RON.
hu — Hungary (vinted.hu), HUF.
dk — Denmark (vinted.dk), DKK.
fi — Finland (vinted.fi), EUR.
hr — Croatia (vinted.hr), EUR.
gr — Greece (vinted.gr), EUR.
ie — Ireland (vinted.ie), EUR.
ee — Estonia (vinted.ee), EUR.
lv — Latvia (vinted.lv), EUR.
si — Slovenia (vinted.si), EUR.
au — Australia (vinted.com.au), AUD.

item_idinteger

Vinted item id: a search result's id, or the number after /items/ in a Vinted URL. item_id or url is required.

Example: 10671938315

urlstring

A Vinted item URL on any country site. Its own site is used, whatever country says.

Example: https://www.vinted.co.uk/items/10671938315-nike-air-max-size-uk-75

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

p = client.vinted.product(url="https://www.vinted.co.uk/items/10671938315-nike-air-max-size-uk-75")["data"]

print(p["title"], p["price"], p["currency"], p["condition"], p["size"])
print("sold" if p["is_sold"] else "reserved" if p["is_reserved"] else "available",
      "| seller rating", p["seller"]["feedback_reputation"], "from", p["seller"]["feedback_count"], "reviews")

Response

"country": "uk",

"id": 10671938315,

"url": "https://www.vinted.co.uk/items/10671938315-nike-air-max-size-uk-75",

"title": "Nike Air Max Size UK 7.5",

"description": "Size UK 7.5/ EU 42",

"description_translated": false,

"price": 25,

"currency": "GBP",

"size": "7.5",

"condition": "Very good",

"color": "Black",

"material": null,

"uploaded_relative": "4 days ago",

"favourite_count": 13,

"is_reserved": false,

"is_sold": false,

"status_label": null,

"can_buy": true,

"instant_buy": true,

"is_hidden": false,

"response_time": 3125

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") p = client.vinted.product(url="https://www.vinted.co.uk/items/10671938315-nike-air-max-size-uk-75")["data"] print(p["title"], p["price"], p["currency"], p["condition"], p["size"]) print("sold" if p["is_sold"] else "reserved" if p["is_reserved"] else "available", "| seller rating", p["seller"]["feedback_reputation"], "from", p["seller"]["feedback_count"], "reviews")