Vinted

Vinted active listings

Search one page of Vinted active listings by keyword, on Vinted US, UK or 24 European sites, 96 rows a page. Prices are seller asks. No sold search. Results are cached for 15 minutes; a cache miss returns 202 and a job to poll.

get/vinted/listings

Request

  • Base URL: https://api.soldgraph.com/v1
  • URL: https://api.soldgraph.com/v1/vinted/listings
  • Auth: HTTP bearer

Query parameters

qstring required

Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition.

pageinteger

Page to fetch, 1 to 10. Vinted serves 96 rows a page and stops at 960 results. Follow next_page until it is null. Optional.

min_priceinteger

Lowest price, in whole units of the country's currency (US dollars for us). Optional. Must not be more than max_price. You can send it without max_price.

max_priceinteger

Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price.

marketplace'vinted'

Optional. If sent, it must be vinted.

country'us' | 'uk' | 'fr' | 'de' | 'it' | 'es' | 'nl' | 'be' | 'pt' | 'at' | 'lu' | 'ie' | 'pl' | 'se' | 'cz' | 'dk' | 'fi' | 'lt' | 'hu' | 'ro' | 'sk' | 'hr' | 'gr' | 'si' | 'lv' | 'ee'

Which Vinted site to search: us (vinted.com), uk (vinted.co.uk) or a European site such as fr, de, it, es, nl or pl. Results, prices, min_price and max_price use that site's currency. Optional.

sort'best_match' | 'newest' | 'price_asc' | 'price_desc'

Vinted's own ranking, newest listed first, or item price low to high or high to low. best_match mixes in promoted listings, flagged with promoted.

conditionstring[]

Vinted's own conditions. Send one or more, separated by commas, like new_with_tags,very_good. Vinted applies the filter.

brand_idinteger

Vinted numeric brand ID, such as 53 for Nike or 10 for Levi's. Keeps only that brand. Find one as brand_id on /v1/vinted/item. Optional.

category_idinteger

Vinted numeric category ID, such as 1242 for men's trainers. Keeps only listings in that category. Find one as category.id on /v1/vinted/item. Optional.

Headers

Idempotency-Keystring

Send the same key when you retry the same search, so you aren't charged twice. 1–128 printable ASCII characters, no spaces.

Response

Complete, including cache hits. Costs 1 request.

request_idstring required

ID of this request. Poll it at /v1/jobs/{request_id}.

status'pending' | 'complete' | 'failed' required

pending, complete or failed. Always check it, even on HTTP 200.

creditsinteger required

Requests charged: 1 when complete, 0 for a page past the last one, while pending, or when failed.

cachedboolean required

True when the result came from the 15-minute cache.

poll_urlstring

Only while pending. A path like /v1/jobs/{id}: join it to https://api.soldgraph.com, not to the /v1 base URL.

Changes

No recorded changes to this operation across all 1 revision of this API.