Vinted API: Search listings
Searches public Vinted listings in one country with brand, size, condition, price and sorting filters. Returns up to 96 available items with seller usernames when the public profile is available.
Unofficial. Not affiliated with or endorsed by Vinted.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Size optional
size Size as shown on listings, for example M or 38.
Not set
- Sort optional
sort Listing order, for example newest.
relevance (default)
One of
relevance,newest,price_low_to_high,price_high_to_low.- Brand optional
brand Brand name, for example Levi's.
Not set
- Query, required
query Words to search for, for example Levi's 501 jeans.
Levi's 501
- Country optional
country Country name or two-letter code, for example France or FR.
France (default)
- Condition optional
condition Item condition, for example very_good.
any (default)
One of
any,new_with_tags,new_without_tags,very_good,good,satisfactory.- Max Price optional
max_price Highest item price in the country’s currency, for example 80.
Not set
Number 0 or more.
- Min Price optional
min_price Lowest item price in the country’s currency, for example 15.
Not set
Number 0 or more.
- Max Results optional
max_results Maximum listings to return, for example 20.
96
Whole number from 1 to 96. Default
20.
Input as JSON
{ "query": "Levi's 501", "max_results": 96}Output
{ "items": [ { "size": "W33 | FR 42", "brand": "Levi's", "price": 32, "title": "Levi’s 501 jeans", "currency": "EUR", "condition": "Très bon état", "item_link": "https://www.vinted.fr/items/10173217767-levis-501-jeans" , "image_link": "https://images1.vinted.net/t/06_0044e_SJAZEnGZ93cDdCY7W5Wb7YVS/310x430/56b5e131.webp?s=ce403e996db5956f59d13e87410c2cf2549d7acd" , "total_price": 34.3, "vinted_item_id": "10173217767", "seller_username": "kolyamba11", "favourites_count": 9 }, { "size": "W32 | FR 42", "brand": "Levi's", "price": 28, "title": "Jean Levi’s 501 noir", "currency": "EUR", "condition": "Très bon état", "item_link": "https://www.vinted.fr/items/10164592237-jean-levis-501-noir" , "image_link": "https://images1.vinted.net/t/04_00b8b_3to1r7XKb2KSXJNGpFerUPCN/310x430/a7b41901.webp?s=487f488ec3f7541624f728eceb6cfc747c9f7d8d" , "total_price": 30.1, "vinted_item_id": "10164592237", "seller_username": "kinglader64", "favourites_count": 24 }, { "size": "W31 | FR 40", "brand": "Levi's", "price": 32.99, "title": "Jean Levi’s 501 coupe droite bleu marine effet vintage - Taille W31/L34 - 40FR / #LE-2505" , "currency": "EUR", "condition": "Très bon état", "item_link": "https://www.vinted.fr/items/10159849206-jean-levis-501-coupe-droite-bleu-marine-effet-vintage-taille-w31l34-40fr-le-2505" , "image_link": "https://images1.vinted.net/t/02_00d62_uzV761TwCBwBpGvSEYxchFWA/310x430/b57d6867.webp?s=5bf81f2ed445b6354089da2d617f19d7a73c5e82" , "total_price": 35.34, "vinted_item_id": "10159849206", "seller_username": "sneakizz69", "favourites_count": 12 } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"vinted.com/search_listings","input":{"query":"Levi' \''s 501","max_results":96}}'# Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "vinted.com/search_listings" , "input": { "query": "Levi's 501", "max_results": 96 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "vinted.com/search_listings" , "input": { "query": "Levi's 501", "max_results": 96 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run vinted.com/search_listings# with {"query":"Levi's 501","max_results":96}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "query" ], "properties": { "size": { "type": "string", "description": "Size as shown on listings, for example M or 38." }, "sort": { "enum": [ "relevance", "newest", "price_low_to_high", "price_high_to_low" ], "type": "string", "default": "relevance", "description": "Listing order, for example newest." }, "brand": { "type": "string", "description": "Brand name, for example Levi's." }, "query": { "type": "string", "description": "Words to search for, for example Levi's 501 jeans." }, "country": { "type": "string", "default": "France", "description": "Country name or two-letter code, for example France or FR." }, "condition": { "enum": [ "any", "new_with_tags", "new_without_tags", "very_good", "good", "satisfactory" ], "type": "string", "default": "any", "description": "Item condition, for example very_good." }, "max_price": { "type": "number", "minimum": 0, "description": "Highest item price in the country’s currency, for example 80." }, "min_price": { "type": "number", "minimum": 0, "description": "Lowest item price in the country’s currency, for example 15." }, "max_results": { "type": "integer", "default": 20, "maximum": 96, "minimum": 1, "description": "Maximum listings to return, for example 20.", "x-fous-developer": true } }, "additionalProperties": false}Output schema
{ "type": "object", "required": [ "items" ], "properties": { "items": { "type": "array", "items": { "type": "object", "required": [ "title", "price", "currency", "total_price", "brand", "size", "condition", "seller_username", "favourites_count", "image_link", "item_link", "vinted_item_id" ], "properties": { "size": { "type": [ "string", "null" ], "description": "Size shown on the listing." }, "brand": { "type": [ "string", "null" ], "description": "Brand shown on the listing." }, "price": { "type": "number", "description": "Listed item price." }, "title": { "type": "string", "description": "Item title." }, "currency": { "type": "string", "description": "Currency code, for example EUR." }, "condition": { "type": [ "string", "null" ], "description": "Condition shown on the listing." }, "item_link": { "type": "string", "description": "Public item page." }, "image_link": { "type": [ "string", "null" ], "description": "Listing image link." }, "total_price": { "type": [ "number", "null" ], "description": "Item price including buyer protection when shown; excludes shipping." }, "vinted_item_id": { "type": "string", "description": "Vinted item identifier.", "x-fous-developer": true }, "seller_username": { "type": [ "string", "null" ], "description": "Seller account username." }, "favourites_count": { "type": [ "integer", "null" ], "description": "Number of favourites." } }, "additionalProperties": false }, "description": "Listings in the requested order." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
vinted.com/search_listings- Returns
- title, price, currency, total price, brand, size, condition, seller, favourites, image, link, item id
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method vinted.com/search_listings with the inputs above.
Ask your agent
- Find secondhand Levi's 501 jeans in size 32 on Vinted in Germany, under 40 euros, newest first
- Looking for a Patagonia fleece size M, very good condition, between £20 and £60 in the UK — cheapest first please
- Show me new-with-tags Nike Air Force 1 sneakers size 42 listed in Italy, up to 80 EUR
- Any Zara wool coats size 38 for sale in Spain under 50 euros? I'd like the top 40 results with seller names and links
- Search Vinted France for Sézane dresses size 36 in good condition or better, sorted by price high to low
See more
Searches clothes and shoes in one Zalando country shop, with optional gender, brand, deal and sort filters. Prices and discounts are those shown on the product cards; size-dependent prices may be starting prices.
zalando.com/search_productsSearches Mercari US listings for items for sale or sold, with condition, price and sorting filters, and adds seller, size and shipping details from each item page. Sold prices are displayed listing prices.
mercari.com/search_listingsFinds Vivino wines matching a wine name (optionally with the winery and a vintage year), in Vivino relevance order, with ratings, vintage, origin, bottle photo and the US price when shown.
vivino.com/search_winesSearches Nike products in a chosen country, in Nike search order, with optional gender (men, women, kids) and sale-only filters. Prices, currency and availability reflect the selected country's Nike store.
nike.com/search_productsSearches a country's English Zara store for products, with current prices, colours, images and product links. The all section excludes non-Zara brands.
zara.com/search_productsSearches AliExpress listings by product words, shipping destination, price range and sort order. Unpriced promotional cards are omitted; free shipping is marked only when the listing explicitly says so.
aliexpress.com/search_productsLists top-rated wines of a chosen type within a budget, from bottles offered in the United States, optionally limited to one grape and country of origin. Prices are in USD.
vivino.com/list_recommended_winesSearches H&M clothing and home products by keyword, with country-specific prices and an optional sale-only filter.
hm.com/search_products