Vinted Listing Data API

Developers can search Vinted's US catalog through Find & Flip's asynchronous listing API. Submit keywords and retrieve available listing fields without buying a subscription.

Read the public docs Create an API key

What the API does

Vinted Listing Data API, explained

Developers can search Vinted's US catalog through Find & Flip's asynchronous listing API. Submit keywords and retrieve available listing fields without buying a subscription.

Pricing in USD

$1.50 / 1,000 listings

20 returned listings cost $0.03 at standard rates. Prepaid API credits start at $10. No API subscription is required; API credits are separate from sourcing plans and AI credits.

Creating a search reserves its maximum cost. Only returned listings are billed; unused reservations are released. Status checks, repeated result reads, and empty searches have no listing charge. Custom account rates are shown by GET /api/v1/balance.

Supported markets and coverage

US catalog only. Vinted requests do not accept searchZip or maxRadius. Supported sortBy values are best_match, creation_time, and price. Other Vinted country catalogs are not advertised as supported.

Searches are asynchronous. Results depend on source availability and worker capacity; no fixed response time or completeness guarantee is advertised.

Request and response examples

Documentation is public. A verified account, an API key, and sufficient prepaid credits are required to run searches.

1. Submit a search

curl -X POST 'https://findandflip.io/api/v1/jobs' \
  -H 'Authorization: Bearer ffapi_YOUR_KEY' \
  -H 'Idempotency-Key: example-search-001' \
  -H 'Content-Type: application/json' \
  -d '{"marketplace": "vinted", "query": "Levi'"'"'s 501 jeans", "maxResults": 20, "sortBy": "creation_time", "collectAdditionalDetails": true}'

The response includes an id and job status. Save that ID.

2. Poll status, then read results

GET /api/v1/jobs/{job_id}
GET /api/v1/jobs/{job_id}/results?offset=0&limit=50

Send the same Bearer header for reads. Poll every 2–5 seconds. Read results after completed; requesting them earlier returns 409.

Illustrative results JSON

Synthetic example only. These are not live listings or verified sales. Source fields vary and can be missing or null. eBay soldPrice is numeric; other marketplaces expose price as source text.

{
  "jobId": "67b201a6-c3b5-49fc-9f82-d3e50281e761",
  "marketplace": "vinted",
  "offset": 0,
  "count": 1,
  "total": 1,
  "items": [
    {
      "marketplace": "vinted",
      "title": "Levi's 501 jeans",
      "price": "$25.00"
    }
  ]
}

Limits and important distinctions

Results show current listings and asking prices, not verified sales. Brand, size, condition, and seller fields depend on the source and may be absent. This is not an official Vinted API, an exhaustive catalog export, or a guarantee that an item remains available.

Request 1–50 results per search; fewer may be returned.
120 requests per key per minute; normally two active searches per account, subject to worker capacity.
Use the same Idempotency-Key and request body when retrying. A new key creates an independently billable search.
Respect Retry-After on 429 responses. Failed or cancelled jobs release their reservation; completed jobs retain their final charge.
Find & Flip supplies listing research. You remain responsible for checking condition, authenticity, fees, and resale assumptions.

All parameters · Errors and limits · OpenAPI schema · Ask about coverage or volume pricing

Vinted Listing Data API