Vinted — search item listings
TL;DR
About
Most people who want this flip clothes and check Vinted several times a day. Only the US catalogue at www.vinted.com is searched, so vinted.fr, vinted.de and vinted.co.uk listings are out of reach. Say you resell Levi's and search "levis 501" with order newest_first and price_to 20. Up to 96 of the newest cards come back, sometimes mostly women's cutoffs sized "XS / US 2" with the odd men's "W32" pair. Keep the W32 cards and pass their ids to get_item, since measurements tend to sit in the description, and use send_message_to_seller for anything the photos leave open. Prices arrive as display strings like "$10.00", so parse them before comparing. Results are read off Vinted's page markup, so a redesign on their side can break this until the script is updated. Vinted's own Pro Integrations API won't help: it is open only to allowlisted Pro businesses, for their own items, orders and webhooks, and has no catalogue search.
Input
query requiredFree-text search, e.g. "levis 501" or "nike air max".
page optionalResult page, 96 items per page. Pages are near-disjoint but not a frozen snapshot: newly listed items shift the window, so consecutive pages fetched minutes apart can repeat a couple of items.
Default: 1order optionalSort order. Omit for the site default (relevance).
price_to optionalMaximum item price, in the currency the run's session resolves to.
price_from optionalMinimum item price, in the currency the run's session resolves to.
Output
page requireditems requiredsearch_url requiredExample output
Shape only: placeholder values generated from the output schema, not a real run.
{
"page": 1,
"items": [
{
"id": "abc123",
"url": "https://example.com/item/123",
"size": "…",
"brand": "…",
"price": "…",
"title": "Example",
"condition": "…",
"image_url": "https://example.com/item/123",
"favourites": 3,
"total_price": 3
}
],
"search_url": "https://example.com/item/123"
}FAQ
Vinted — read one item listing
Read a single Vinted listing from its link or id: title, full description, price and total with Buyer Protection, brand, size, condition, colour, material, upload time, category path, every photo, favourite count and the seller's profile.
Vinted login (Google SSO)
Log into Vinted with Continue with Google on the country site where your account lives (vinted.fr by default; pass `domain`, e.g. www.vinted.com), handling the Google account chooser and consent screen. Declines non-essential cookies on the banner. Returns straight away if you are already signed in, and reports the Vinted account email. If the Google account has no Vinted account on that site, it stops instead of signing up; a captcha is named rather than attempted. Needs a browser already signed in to Google.
Create a Vinted listing
Create a for-sale listing on Vinted from a photo, title, description, category, condition, price and package size (plus an ISBN for books). Works on whichever Vinted country site the browser is signed in to. Defaults to a dry run that fills the whole form and publishes nothing; saveAsDraft keeps the listing private, otherwise it is published. Confirms the result by reopening the saved item. Categories that also ask for brand or size, such as clothing, are refused for now rather than listed incomplete.