Vinted filtered search

Search Vinted listings with catalog, size, brand, condition, color, pattern, material, price, and sort filters.

POST /v1/vinted/search/filtered

Request Parameters

Name	In	Type	Required	Description
query	body	string	Yes	Vinted search term.
brand_ids	body	string	No	Brand filter IDs. Accepts a comma-separated string or an array.
catalog	body	string	No	Catalog/category IDs. Accepts a comma-separated string or an array.
catalog_ids	body	string	No	Catalog/category IDs. Accepts a comma-separated string or an array.
color_ids	body	string	No	Color filter IDs. Accepts a comma-separated string or an array.
domain	body	string	No	Optional Vinted domain/origin (e.g. vinted.de, www.vinted.fr, or https://www.vinted.co.uk). Defaults to UK.
material_ids	body	string	No	Material filter IDs. Accepts a comma-separated string or an array.
order	body	string	No	Sort order (e.g. relevance, newest_first, price_high_to_low).
pages	body	number	No	Number of result pages to fetch (1-20).
patterns_ids	body	string	No	Pattern filter IDs. Accepts a comma-separated string or an array.
price_from	body	string	No	Minimum item price.
price_to	body	string	No	Maximum item price.
size_ids	body	string	No	Size filter IDs. Accepts a comma-separated string or an array.
status_ids	body	string	No	Condition/status filter IDs. Accepts a comma-separated string or an array.

Response Structure

Async kickoff response

Polled run result response

Sync response

Declared output schema

Code Examples

Async + polling

RUN=$(curl -s -X POST "https://api.browsable.app/v1/vinted/search/filtered" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"London","brand_ids":"id-1","catalog":"sample","catalog_ids":"id-1","color_ids":"id-1","domain":"vinted.co.uk","material_ids":"id-1","order":"relevance","pages":1,"patterns_ids":"id-1","price_from":"180","price_to":"180","size_ids":"id-1","status_ids":"id-1"}')

RUN_ID=$(echo "$RUN" | jq -r '.run_id')

while true; do
  RESULT=$(curl -s -H "Authorization: Bearer YOUR_API_KEY" "https://api.browsable.app/v1/runs/$RUN_ID")
  STATUS=$(echo "$RESULT" | jq -r '.run_status')
  if [ "$STATUS" = "succeeded" ] || [ "$STATUS" = "failed" ]; then
    echo "$RESULT"
    break
  fi
  sleep 2
done

Sync

curl -X POST "https://api.browsable.app/v1/vinted/search/filtered" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"London","brand_ids":"id-1","catalog":"sample","catalog_ids":"id-1","color_ids":"id-1","domain":"vinted.co.uk","material_ids":"id-1","order":"relevance","pages":1,"patterns_ids":"id-1","price_from":"180","price_to":"180","size_ids":"id-1","status_ids":"id-1","_run":{"async":false}}'