Search by image
Supply a photo URL or upload an image to find similar active listings.
Text search
Filter listings by category, brand, price, size, material, color and condition.
76 read operations
Explore sold comparables, suggested prices, seller feedback and reference data.
Explore the same sections as the playground
The Vinted playground groups endpoints by what they do. All Vinted requests use the mobile transport.
The 85 entries include the normalized endpoints and 76 discoverable read
operations. Get the operation catalog
for current names, required parameters and runnable examples. Image search is a
separate endpoint, not one of those 76 read operations.
Quick start
Choose a market
market defaults to fr. Supported codes:
fr, de, es, it, nl, be, pt, pl, lt, cz, at, sk, hu, ro,
lu, fi, dk, se, gb, lv, hr, ee, gr, ie, si, us, au.
uk is accepted as an alias for gb.
List markets to get their domains,
locales and currency codes. Market selects the catalog region and locale; it does
not restrict the seller’s physical country. European markets can contain listings
from sellers across borders. Prices retain the market currency; ScrapeBadger does
not perform currency conversion.
Text search also supports seller_country to filter by seller location after
retrieval. Its pagination totals describe the upstream results before that filter,
so a returned page may contain fewer items than requested.
Filters and pagination
Both text and image search acceptbrand_ids, catalog_ids, status_ids,
color_ids, size_ids, material_ids, price_from, price_to, page and
per_page (1–96). IDs are comma-separated. Discover IDs in the reference endpoints
or operation catalog. catalog_ids filters categories before retrieval.
Text search accepts order; image search uses visual ranking. For subsequent
pages, reuse pagination.time as time and keep search_session_id consistent.
Image search also requires the same image source on each page. Deduplicate results
by item ID because listings can change while you paginate.
Response formats and field availability
- Normalized search returns
items,paginationandmarket. - Read operations return
operation,marketand upstream JSON underdata. - Listing summaries include prices, URLs, photos, display labels and available size/condition information. Labels may be localized.
brand_titlecan be null when Vinted omits structured brand data.display_titleis a display label; do not treat it as a reliable brand ID.- Image search supplies no similarity or confidence score.
- Sold comparables are a sample of sold listings, not exhaustive history. Their displayed prices are not guaranteed final negotiated sale prices.
Pricing
Failed requests are free. Check
X-Credits-Used for the billed amount and the
live pricing page for current rates.
