v1

latestOpenAPI 3.1.02026-07-26180242448.0 KB

Search Items

Search Vinted catalog items with filters.

get/v1/vinted/search

Query parameters

querystring required

Search query string. Matches against item titles and descriptions.

marketstring

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

pageinteger

Page number for paginated results.

per_pageinteger

Number of items per page.

price_fromnumber

Minimum price filter in the market's local currency.

price_tonumber

Maximum price filter in the market's local currency.

brand_idsstring

Comma-separated list of brand IDs to filter by.

color_idsstring

Comma-separated list of color IDs to filter by.

status_idsstring

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

order'relevance' | 'price_low_to_high' | 'price_high_to_low' | 'newest_first'

Sort order for results.

seller_countrystring

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: 1 base credit + 1 credit per uncached seller looked up (seller country cached 7 days; cache hits are free).

Response

Successful search

total_entriesinteger

Total number of matching items across all pages. Reflects Vinted's unfiltered totals even when seller_country filtering is applied.

current_pageinteger

Current page number.

per_pageinteger

Number of items per page.

seller_countrystring nullable

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.