Vinted Search
Search Vinted second-hand listings by keyword or catalog URL across vinted.fr, vinted.com and other domains. Returns results and pagination.
Credit cost: 1 credit per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringSearch keyword or full Vinted catalog URL. Filters from the URL query string are forwarded to the internal Vinted API.
Examples (keyword):
nikeExample (catalog URL):
https://www.vinted.com/catalog?search_text=dresses%20for%20womanNotes:
- Keyword searches default to
vinted.frunless you setregion. - Catalog URLs keep their domain (
vinted.com,vinted.de, etc.).
page?numberPage number. Default 1.
per_page?numberResults per page. Default 24.
order?stringOptional sort order.
newest_first
relevanceprice_low_to_highprice_high_to_lowregion?stringForce the Vinted domain when query is a keyword only.
Examples:
frhttps://www.vinted.frhttps://www.vinted.defields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.com/v2/vinted/search?query=string'{ "results": [ { "id": 10671681930, "url": "https://www.vinted.com/items/10671681930-boutique-clothes", "path": "/items/10671681930-boutique-clothes", "photo": { "url": "https://images1.vinted.net/t/06_017cb_ii7N7PvDJ8YN3Q5QLceLKpxf/310x430/260556ef.webp?s=2201d1dccba5648071e278363d6469c2b7d8e499" }, "price": { "amount": "$4.00", "currency_code": "USD" }, "title": "boutique clothes", "status": "New without tags", "size_title": "S / US 4-6" } ], "pagination": { "next": 2, "page": 1, "per_page": 24, "total_pages": 21, "total_results": 500 }}