Skip to main content
GET
Search Items

Query Parameters

string
required
Search query string. Matches against item titles and descriptions.
string
default:"fr"
Vinted market to search. See /v1/vinted/markets for all supported values.Examples: fr, de, uk, it, es, pl, us
integer
default:1
Page number for paginated results. Starts at 1.
integer
default:20
Number of items per page. Range: 1 - 96.
number
Minimum price filter in the market’s local currency.
number
Maximum price filter in the market’s local currency.
string
Comma-separated list of Vinted catalog (category) IDs. Vinted applies this before the search runs, so you get whole pages of in-category results instead of filtering them out afterwards.A catalog ID is the 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[]=221catalog_ids=221.Sub-categories are included: catalog_ids=221 (Women’s T-shirts) also matches the brand-specific leaves beneath it.Example: 221, 221,1242
Catalog IDs are per market. An ID read off vinted.fr is not guaranteed to mean the same category on vinted.de — take the ID from the same market you pass as market.
string
Comma-separated list of brand IDs to filter by. Use /v1/vinted/brands to look up IDs.Example: 53, 14,53,221
string
Comma-separated list of color IDs to filter by. Use /v1/vinted/colors to look up IDs.Example: 1, 1,4,12
string
Comma-separated list of condition status IDs to filter by. Use /v1/vinted/statuses to look up IDs.Example: 6 (New with tags), 1,2 (New without tags, Very good)
string
default:"relevance"
Sort order for results.
string
Comma-separated list of ISO 3166-1 alpha-2 country codes (case-insensitive) to keep only items whose seller is physically located in one of those countries.Vinted markets federate listings across borders — a search on 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,ES
market 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.
Pagination totals (total_entries / total_pages) reflect Vinted’s unfiltered result set. After seller-country filtering, a page may contain fewer than per_page items (or none), even though more matching items exist on later pages. Iterate through pages until you have collected enough matching items.

Response

array
Array of matching items.
object
string
Echo of the market that was searched.
string
Echo of the normalized 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:
A search costs 5 credits, whatever filters you pass — including 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

x-api-key
string
header
required

Query Parameters

query
string
required

Search query string. Matches against item titles and descriptions.

market
string
default:fr

Vinted market to search (e.g. fr, de, uk, it, es, pl, us).

page
integer
default:1

Page number for paginated results.

Required range: x >= 1
per_page
integer
default:20

Number of items per page.

Required range: 1 <= x <= 96
price_from
number

Minimum price filter in the market's local currency.

price_to
number

Maximum price filter in the market's local currency.

catalog_ids
string

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.

brand_ids
string

Comma-separated list of brand IDs to filter by.

color_ids
string

Comma-separated list of color IDs to filter by.

status_ids
string

Comma-separated list of condition status IDs to filter by.

order
enum<string>
default:relevance

Sort order for results.

Available options:
relevance,
price_low_to_high,
price_high_to_low,
newest_first
seller_country
string

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

200 - application/json

Successful search

items
object[]
pagination
object
market
string

Echo of the market that was searched.

seller_country
string | null

Echo of the normalized seller_country filter that was applied (uppercase, comma-separated ISO-2 codes, e.g. "FR,BE"), or null when no filter was requested.