Search Items
Search Vinted catalog items with filters.
Query Parameters
/v1/vinted/markets for all supported values.Examples: fr, de, uk, it, es, pl, us1.1 - 96.catalog[] value in a Vinted category URL — browse to the
category on the Vinted site and read it off the address bar:
vinted.fr/catalog?catalog[]=221 → catalog_ids=221.Sub-categories are included: catalog_ids=221 (Women’s T-shirts) also matches
the brand-specific leaves beneath it.Example: 221, 221,1242vinted.fr is not guaranteed
to mean the same category on vinted.de — take the ID from the same market
you pass as market./v1/vinted/brands to look up IDs.Example: 53, 14,53,221/v1/vinted/colors to look up IDs.Example: 1, 1,4,12/v1/vinted/statuses to look up IDs.Example: 6 (New with tags), 1,2 (New without tags, Very good)vinted.fr returns items from sellers in IT, DE, NL, ES, and elsewhere (prices and labels are localized, but the seller is abroad). Vinted exposes no native country facet, so ScrapeBadger resolves each result item’s seller country and drops items outside the requested set.Examples: fr, fr,be, IT,ESmarket and seller_country are different axes. market selects which Vinted domain you search (which catalog and currency you see); seller_country filters on where the seller actually is. For example, market=fr&seller_country=it searches the French catalog but returns only items shipped by sellers in Italy.Response
seller_country filter that was applied (uppercase, comma-separated ISO-2 codes, e.g. "FR,BE"), or null when no filter was requested.Example Response
Example Request — filter by category
Only women’s T-shirts (catalog[]=221 on vinted.fr):
Example Request — filter by seller country
Return only listings from sellers physically located in France:seller_country, whose seller lookups are not billed on top. Failed requests are not charged. The exact charge for any call is returned in the X-Credits-Used response header.Authorizations
Query Parameters
Search query string. Matches against item titles and descriptions.
Vinted market to search (e.g. fr, de, uk, it, es, pl, us).
Page number for paginated results.
x >= 1Number of items per page.
1 <= x <= 96Minimum price filter in the market's local currency.
Maximum price filter in the market's local currency.
Comma-separated Vinted catalog (category) IDs to restrict the search to (e.g. "221" or "221,1242"). Applied by Vinted before the search runs, and sub-categories are included. A catalog ID is the catalog[] value in a Vinted category URL (vinted.fr/catalog?catalog[]=221); IDs are per market.
Comma-separated list of brand IDs to filter by.
Comma-separated list of color IDs to filter by.
Comma-separated list of condition status IDs to filter by.
Sort order for results.
relevance, price_low_to_high, price_high_to_low, newest_first Comma-separated ISO 3166-1 alpha-2 country codes (case-insensitive) to keep only items whose seller is physically located in one of those countries (e.g. "fr" or "fr,be"). Vinted markets federate cross-border listings; this filters on the seller's real location, which is a different axis from market. Note: pagination totals stay unfiltered, so a page may return fewer than per_page items after filtering. Billing: a search is a flat 5 credits whatever filters you pass; seller lookups are not billed on top.
Response
Successful search

