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[]=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,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.
Value
Description
relevance
Best match (default)
price_low_to_high
Cheapest first
price_high_to_low
Most expensive first
newest_first
Most recently listed
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.
Show Item object
integer
Item ID.
string
Item title.
object
Price object: amount (decimal string, e.g. "45.0") and currency_code (ISO 4217, e.g. "EUR").
string
Buyer-protection fee as a decimal string, in price.currency_code. null when Vinted doesn’t quote one.
string
Price + buyer protection as a decimal string, in price.currency_code.
string
Brand name.
string
Size label.
string
Item condition, localized to the market (e.g. "Très bon état").
Whether the listing is a promoted/bumped placement.
string
Vinted’s own label for where the result came from (e.g. "search").
string
ISO 3166-1 alpha-2 code of the seller’s physical country (e.g. "IT"). Populated only when seller_country filtering was requested; null otherwise.
object
Show Pagination object
integer
Current page number.
integer
Number of items per page.
integer
Total number of pages.
integer
Total number of matching items. Vinted caps this at 960 on deep result sets, so treat it as an upper bound rather than an exact count.
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.
const results = await client.vinted.search({ query: "nike air force 1", market: "fr", seller_country: "fr", per_page: 20,});
results = client.vinted.search( query="nike air force 1", market="fr", seller_country="fr", per_page=20,)
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.
Mobile search additions
size_ids and material_ids accept comma-separated filter IDs. Reuse the returned pagination time and a shared search_session_id across pages. Search item display_title / display_subtitle preserve presentation labels; brand_title can be null. Use item details for verified brand, category and condition IDs. See mobile data.
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.
size_ids
string | null
Comma-separated size IDs
material_ids
string | null
Comma-separated material IDs
time
integer | null
Pagination time returned by the preceding page
Required range: x >= 0
search_session_id
string | null
Reuse across pages of one search
Response
200 - application/json
Successful search
items
object[]
Show child attributes
pagination
object
Show child attributes
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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ScrapeBadger","colors":{"primary":"#16A34A","light":"#22C55E","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/scrapebadger/gnGR4eL2rEJ4E7w3/logo/light.png?fit=max\u0026auto=format\u0026n=gnGR4eL2rEJ4E7w3\u0026q=85\u0026s=d393e30b48870f8495f788d1fad76ad3","dark":"https://mintcdn.com/scrapebadger/pHswKIBb9VFWmUQY/logo/dark.png?fit=max\u0026auto=format\u0026n=pHswKIBb9VFWmUQY\u0026q=85\u0026s=a5c2b0f2229bc45c6de7fb33b2318941"},"favicon":"https://mintcdn.com/scrapebadger/q5UXhzQrMbsIglQS/favicon.png?fit=max\u0026auto=format\u0026n=q5UXhzQrMbsIglQS\u0026q=85\u0026s=cf0ec94b52375fd84ae198f26e812030","api":{"openapi":["https://scrapebadger.com/api/twitter-openapi.json","openapi-web-scraping.json","openapi-vinted.json","openapi-amazon.json","openapi-rufus.json","openapi-meta-ai.json","openapi-ebay.json","openapi-realtor.json","openapi-zillow.json","openapi-tiktok.json","openapi-reddit.json","openapi-google.json","openapi-account.json","openapi-github.json","openapi-autoscout24.json","openapi-brave.json","openapi-yelp.json","openapi-facebook.json"],"playground":{}},"navbar":{"links":[{"href":"mailto:support@scrapebadger.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://scrapebadger.com/dashboard?utm_source=docs\u0026utm_medium=referral"}},"footer":{"socials":{"x":"https://x.com/scrapebadger","github":"https://github.com/scrape-badger"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://scrapebadger.com/dashboard?utm_source=docs\u0026utm_medium=referral"},{"anchor":"Pricing","icon":"credit-card","href":"https://scrapebadger.com/pricing"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"scrapebadger","hasAudioNarration":false,"actualSubdomain":"scrapebadger","customDomains":["docs.scrapebadger.com"],"gitSource":{"type":"github","owner":"scrape-badger","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6afe23e9ca69d9f668a09a72","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Search","count":71},{"language":"default","tag":"Twitter","count":62},{"language":"default","tag":"Naver","count":56},{"language":"default","tag":"Google","count":50},{"language":"default","tag":"Overview","count":46},{"language":"default","tag":"Reference","count":41},{"language":"default","tag":"Endpoints","count":39},{"language":"default","tag":"TikTok","count":36},{"language":"default","tag":"Users","count":29},{"language":"default","tag":"Getting Started","count":27}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".nav-tabs{min-width:0;overflow-x:auto;overscroll-behavior-x:contain;scrollbar-width:thin}.nav-tabs-item{flex-shrink:0;white-space:nowrap}"}]}
{"page":{"pagePath":"api-reference/endpoint/vinted/search-items","slug":"/api-reference/endpoint/vinted/search-items","pageMetadata":{"title":"Search Items","openapi":"GET /v1/vinted/search","description":"Search Vinted catalog items with filters.","href":"/api-reference/endpoint/vinted/search-items"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Search Vinted catalog items with filters.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Expandable,Heading,Note,ParamField,ResponseField,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsx(ParamField,{query:`query`,type:`string`,required:true,id:`param-query`,children:_jsx(_components.p,{children:`Search query string. Matches against item titles and descriptions.`})}),`\n`,_jsxs(ParamField,{query:`market`,type:`string`,default:`fr`,id:`param-market`,children:[_jsxs(_components.p,{children:[`Vinted market to search. See `,_jsx(_components.a,{href:`/api-reference/endpoint/vinted/list-markets`,children:_jsx(_components.code,{children:`/v1/vinted/markets`})}),` for all supported values.`]}),_jsxs(_components.p,{children:[`Examples: `,_jsx(_components.code,{children:`fr`}),`, `,_jsx(_components.code,{children:`de`}),`, `,_jsx(_components.code,{children:`uk`}),`, `,_jsx(_components.code,{children:`it`}),`, `,_jsx(_components.code,{children:`es`}),`, `,_jsx(_components.code,{children:`pl`}),`, `,_jsx(_components.code,{children:`us`})]})]}),`\n`,_jsx(ParamField,{query:`page`,type:`integer`,default:1,id:`param-page`,children:_jsxs(_components.p,{children:[`Page number for paginated results. Starts at `,_jsx(_components.code,{children:`1`}),`.`]})}),`\n`,_jsx(ParamField,{query:`per_page`,type:`integer`,default:20,id:`param-per-page`,children:_jsxs(_components.p,{children:[`Number of items per page. Range: `,_jsx(_components.code,{children:`1`}),` - `,_jsx(_components.code,{children:`96`}),`.`]})}),`\n`,_jsx(ParamField,{query:`price_from`,type:`number`,id:`param-price-from`,children:_jsx(_components.p,{children:`Minimum price filter in the market’s local currency.`})}),`\n`,_jsx(ParamField,{query:`price_to`,type:`number`,id:`param-price-to`,children:_jsx(_components.p,{children:`Maximum price filter in the market’s local currency.`})}),`\n`,_jsxs(ParamField,{query:`catalog_ids`,type:`string`,id:`param-catalog-ids`,children:[_jsxs(_components.p,{children:[`Comma-separated list of Vinted catalog (category) IDs. Vinted applies this\n`,_jsx(_components.strong,{children:`before`}),` the search runs, so you get whole pages of in-category results\ninstead of filtering them out afterwards.`]}),_jsxs(_components.p,{children:[`A catalog ID is the `,_jsx(_components.code,{children:`catalog[]`}),` value in a Vinted category URL — browse to the\ncategory on the Vinted site and read it off the address bar:\n`,_jsx(_components.code,{children:`vinted.fr/catalog?catalog[]=221`}),` → `,_jsx(_components.code,{children:`catalog_ids=221`}),`.`]}),_jsxs(_components.p,{children:[`Sub-categories are included: `,_jsx(_components.code,{children:`catalog_ids=221`}),` (Women’s T-shirts) also matches\nthe brand-specific leaves beneath it.`]}),_jsxs(_components.p,{children:[`Example: `,_jsx(_components.code,{children:`221`}),`, `,_jsx(_components.code,{children:`221,1242`})]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`Catalog IDs are `,_jsx(_components.strong,{children:`per market`}),`. An ID read off `,_jsx(_components.code,{children:`vinted.fr`}),` is not guaranteed\nto mean the same category on `,_jsx(_components.code,{children:`vinted.de`}),` — take the ID from the same market\nyou pass as `,_jsx(_components.code,{children:`market`}),`.`]})})]}),`\n`,_jsxs(ParamField,{query:`brand_ids`,type:`string`,id:`param-brand-ids`,children:[_jsxs(_components.p,{children:[`Comma-separated list of brand IDs to filter by. Use `,_jsx(_components.a,{href:`/api-reference/endpoint/vinted/search-brands`,children:_jsx(_components.code,{children:`/v1/vinted/brands`})}),` to look up IDs.`]}),_jsxs(_components.p,{children:[`Example: `,_jsx(_components.code,{children:`53`}),`, `,_jsx(_components.code,{children:`14,53,221`})]})]}),`\n`,_jsxs(ParamField,{query:`color_ids`,type:`string`,id:`param-color-ids`,children:[_jsxs(_components.p,{children:[`Comma-separated list of color IDs to filter by. Use `,_jsx(_components.a,{href:`/api-reference/endpoint/vinted/list-colors`,children:_jsx(_components.code,{children:`/v1/vinted/colors`})}),` to look up IDs.`]}),_jsxs(_components.p,{children:[`Example: `,_jsx(_components.code,{children:`1`}),`, `,_jsx(_components.code,{children:`1,4,12`})]})]}),`\n`,_jsxs(ParamField,{query:`status_ids`,type:`string`,id:`param-status-ids`,children:[_jsxs(_components.p,{children:[`Comma-separated list of condition status IDs to filter by. Use `,_jsx(_components.a,{href:`/api-reference/endpoint/vinted/list-statuses`,children:_jsx(_components.code,{children:`/v1/vinted/statuses`})}),` to look up IDs.`]}),_jsxs(_components.p,{children:[`Example: `,_jsx(_components.code,{children:`6`}),` (New with tags), `,_jsx(_components.code,{children:`1,2`}),` (New without tags, Very good)`]})]}),`\n`,_jsxs(ParamField,{query:`order`,type:`string`,default:`relevance`,id:`param-order`,children:[_jsx(_components.p,{children:`Sort order for results.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`relevance`})}),_jsx(_components.td,{children:`Best match (default)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`price_low_to_high`})}),_jsx(_components.td,{children:`Cheapest first`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`price_high_to_low`})}),_jsx(_components.td,{children:`Most expensive first`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`newest_first`})}),_jsx(_components.td,{children:`Most recently listed`})]})]})]})]}),`\n`,_jsxs(ParamField,{query:`seller_country`,type:`string`,id:`param-seller-country`,children:[_jsxs(_components.p,{children:[`Comma-separated list of ISO 3166-1 alpha-2 country codes (case-insensitive) to keep only items whose `,_jsx(_components.strong,{children:`seller is physically located`}),` in one of those countries.`]}),_jsxs(_components.p,{children:[`Vinted markets federate listings across borders — a search on `,_jsx(_components.code,{children:`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.`]}),_jsxs(_components.p,{children:[`Examples: `,_jsx(_components.code,{children:`fr`}),`, `,_jsx(_components.code,{children:`fr,be`}),`, `,_jsx(_components.code,{children:`IT,ES`})]}),_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`market`}),` and `,_jsx(_components.code,{children:`seller_country`}),` are `,_jsx(_components.strong,{children:`different axes`}),`. `,_jsx(_components.code,{children:`market`}),` selects which Vinted domain you search (which catalog and currency you see); `,_jsx(_components.code,{children:`seller_country`}),` filters on where the seller actually is. For example, `,_jsx(_components.code,{children:`market=fr\u0026seller_country=it`}),` searches the French catalog but returns only items shipped by sellers in Italy.`]})}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`Pagination totals (`,_jsx(_components.code,{children:`total_entries`}),` / `,_jsx(_components.code,{children:`total_pages`}),`) reflect Vinted’s `,_jsx(_components.strong,{children:`unfiltered`}),` result set. After seller-country filtering, a page may contain fewer than `,_jsx(_components.code,{children:`per_page`}),` items (or none), even though more matching items exist on later pages. Iterate through pages until you have collected enough matching items.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`items`,type:`array`,id:`param-items`,children:[_jsx(_components.p,{children:`Array of matching items.`}),_jsxs(Expandable,{title:`Item object`,children:[_jsx(ResponseField,{name:`id`,type:`integer`,id:`param-id`,children:`Item ID.`}),_jsx(ResponseField,{name:`title`,type:`string`,id:`param-title`,children:`Item title.`}),_jsx(ResponseField,{name:`price`,type:`object`,id:`param-price`,children:_jsxs(_components.p,{children:[`Price object: `,_jsx(_components.code,{children:`amount`}),` (decimal string, e.g. `,_jsx(_components.code,{children:`\"45.0\"`}),`) and `,_jsx(_components.code,{children:`currency_code`}),` (ISO 4217, e.g. `,_jsx(_components.code,{children:`\"EUR\"`}),`).`]})}),_jsxs(ResponseField,{name:`service_fee`,type:`string`,id:`param-service-fee`,children:[`Buyer-protection fee as a decimal string, in `,_jsx(_components.code,{children:`price.currency_code`}),`. `,_jsx(_components.code,{children:`null`}),` when Vinted doesn’t quote one.`]}),_jsxs(ResponseField,{name:`total_item_price`,type:`string`,id:`param-total-item-price`,children:[`Price + buyer protection as a decimal string, in `,_jsx(_components.code,{children:`price.currency_code`}),`.`]}),_jsx(ResponseField,{name:`brand_title`,type:`string`,id:`param-brand-title`,children:`Brand name.`}),_jsx(ResponseField,{name:`size_title`,type:`string`,id:`param-size-title`,children:`Size label.`}),_jsxs(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:[`Item condition, localized to the market (e.g. `,_jsx(_components.code,{children:`\"Très bon état\"`}),`).`]}),_jsx(ResponseField,{name:`url`,type:`string`,id:`param-url`,children:`Full URL to the Vinted listing.`}),_jsx(ResponseField,{name:`path`,type:`string`,id:`param-path`,children:`Path portion of the listing URL.`}),_jsxs(ResponseField,{name:`photo`,type:`object`,id:`param-photo`,children:[`Primary photo (`,_jsx(_components.code,{children:`id`}),`, `,_jsx(_components.code,{children:`url`}),`, `,_jsx(_components.code,{children:`full_size_url`}),`, `,_jsx(_components.code,{children:`width`}),`, `,_jsx(_components.code,{children:`height`}),`, `,_jsx(_components.code,{children:`dominant_color`}),`, `,_jsx(_components.code,{children:`is_main`}),`).`]}),_jsxs(ResponseField,{name:`photos`,type:`array`,id:`param-photos`,children:[`All photos, same object shape as `,_jsx(_components.code,{children:`photo`}),`.`]}),_jsxs(ResponseField,{name:`user`,type:`object`,id:`param-user`,children:[`Seller summary (`,_jsx(_components.code,{children:`id`}),`, `,_jsx(_components.code,{children:`login`}),`, `,_jsx(_components.code,{children:`photo_url`}),`, `,_jsx(_components.code,{children:`business`}),`).`]}),_jsx(ResponseField,{name:`favourite_count`,type:`integer`,id:`param-favourite-count`,children:`Number of users who favourited this item.`}),_jsx(ResponseField,{name:`view_count`,type:`integer`,id:`param-view-count`,children:`Number of views.`}),_jsx(ResponseField,{name:`is_visible`,type:`boolean`,id:`param-is-visible`,children:`Whether the listing is publicly visible.`}),_jsx(ResponseField,{name:`promoted`,type:`boolean`,id:`param-promoted`,children:`Whether the listing is a promoted/bumped placement.`}),_jsxs(ResponseField,{name:`content_source`,type:`string`,id:`param-content-source`,children:[`Vinted’s own label for where the result came from (e.g. `,_jsx(_components.code,{children:`\"search\"`}),`).`]}),_jsx(ResponseField,{name:`seller_country_code`,type:`string`,id:`param-seller-country-code`,children:_jsxs(_components.p,{children:[`ISO 3166-1 alpha-2 code of the seller’s physical country (e.g. `,_jsx(_components.code,{children:`\"IT\"`}),`). Populated only when `,_jsx(_components.code,{children:`seller_country`}),` filtering was requested; `,_jsx(_components.code,{children:`null`}),` otherwise.`]})})]})]}),`\n`,_jsx(ResponseField,{name:`pagination`,type:`object`,id:`param-pagination`,children:_jsxs(Expandable,{title:`Pagination object`,children:[_jsx(ResponseField,{name:`current_page`,type:`integer`,id:`param-current-page`,children:`Current page number.`}),_jsx(ResponseField,{name:`per_page`,type:`integer`,id:`param-per-page-1`,children:`Number of items per page.`}),_jsx(ResponseField,{name:`total_pages`,type:`integer`,id:`param-total-pages`,children:`Total number of pages.`}),_jsx(ResponseField,{name:`total_entries`,type:`integer`,id:`param-total-entries`,children:`Total number of matching items. Vinted caps this at 960 on deep result sets, so treat it as an upper bound rather than an exact count.`})]})}),`\n`,_jsx(ResponseField,{name:`market`,type:`string`,id:`param-market-1`,children:_jsx(_components.p,{children:`Echo of the market that was searched.`})}),`\n`,_jsx(ResponseField,{name:`seller_country`,type:`string`,id:`param-seller-country-1`,children:_jsxs(_components.p,{children:[`Echo of the normalized `,_jsx(_components.code,{children:`seller_country`}),` filter that was applied (uppercase, comma-separated ISO-2 codes, e.g. `,_jsx(_components.code,{children:`\"FR,BE\"`}),`), or `,_jsx(_components.code,{children:`null`}),` when no filter was requested.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`example-response`,children:`Example Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`46`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`46`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"items\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`9492962028`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"title\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Nike Air Force 1 '07 White\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"price\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"45.0\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"currency_code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"EUR\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"service_fee\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"3.05\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total_item_price\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"48.05\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"brand_title\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Nike\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"size_title\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"42\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Très bon état\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://www.vinted.fr/items/9492962028-nike-air-force-1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"path\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/items/9492962028-nike-air-force-1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_visible\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"promoted\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"favourite_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`12`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"view_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`234`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"content_source\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"search\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"seller_country_code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"user\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`12345678`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"login\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"seller_username\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"photo_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://images1.vinted.net/t/...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"business\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"photo\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`40179825222`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://images1.vinted.net/t/...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"full_size_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://images1.vinted.net/tc/...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"width\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`600`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"height\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`800`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"dominant_color\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"#36363D\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"is_main\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"photos\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: []`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"pagination\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"current_page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"per_page\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`20`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total_pages\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`48`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total_entries\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`960`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"market\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"fr\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"seller_country\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`example-request-—-filter-by-category`,children:`Example Request — filter by category`}),`\n`,_jsxs(_components.p,{children:[`Only women’s T-shirts (`,_jsx(_components.code,{children:`catalog[]=221`}),` on vinted.fr):`]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://scrapebadger.com/v1/vinted/search?query=nike\u0026market=fr\u0026catalog_ids=221\u0026per_page=20\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: YOUR_API_KEY\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`6`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` results`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` client`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`vinted`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`search`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` query:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"nike\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` market:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"fr\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` catalog_ids:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"221\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` per_page:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 20`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`6`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`results `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` client.vinted.search(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` query`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"nike\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` market`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"fr\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` catalog_ids`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"221\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` per_page`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`20`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`3`,id:`example-request-—-filter-by-seller-country`,children:`Example Request — filter by seller country`}),`\n`,_jsx(_components.p,{children:`Return only listings from sellers physically located in France:`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://scrapebadger.com/v1/vinted/search?query=nike+air+force+1\u0026market=fr\u0026seller_country=fr\u0026per_page=20\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: YOUR_API_KEY\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`6`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` results`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` client`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`vinted`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`search`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` query:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"nike air force 1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` market:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"fr\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` seller_country:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"fr\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` per_page:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 20`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`6`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`results `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` client.vinted.search(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` query`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"nike air force 1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` market`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"fr\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` seller_country`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"fr\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` per_page`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`20`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`]})})})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`A search costs `,_jsx(_components.strong,{children:`5 credits`}),`, whatever filters you pass — including `,_jsx(_components.code,{children:`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 `,_jsx(_components.code,{children:`X-Credits-Used`}),` response header.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`mobile-search-additions`,children:`Mobile search additions`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`size_ids`}),` and `,_jsx(_components.code,{children:`material_ids`}),` accept comma-separated filter IDs. Reuse the returned pagination `,_jsx(_components.code,{children:`time`}),` and a shared `,_jsx(_components.code,{children:`search_session_id`}),` across pages. Search item `,_jsx(_components.code,{children:`display_title`}),` / `,_jsx(_components.code,{children:`display_subtitle`}),` preserve presentation labels; `,_jsx(_components.code,{children:`brand_title`}),` can be null. Use item details for verified brand, category and condition IDs. See `,_jsx(_components.a,{href:`/vinted/mobile-api`,children:`mobile data`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Search Items","openapi":"GET /v1/vinted/search","description":"Search Vinted catalog items with filters.","href":"/api-reference/endpoint/vinted/search-items"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Query Parameters","slug":"query-parameters","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[{"title":"Example Response","slug":"example-response","depth":3,"children":[]},{"title":"Example Request — filter by category","slug":"example-request-—-filter-by-category","depth":3,"children":[]},{"title":"Example Request — filter by seller country","slug":"example-request-—-filter-by-seller-country","depth":3,"children":[]}]},{"title":"Mobile search additions","slug":"mobile-search-additions","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"searchVintedItems","summary":"Search Items","description":"Search Vinted catalog items with filters.","parameters":["1e0a4b5a-4713-45f5-8581-6925a894be93","88556621-bd00-488f-83c9-8e05d147c9ee","25ebad6b-66bc-4498-98e7-f4d7bf968c3a","6f94eeaa-dfa9-4965-a0a0-3b7fad811b2c","08f11854-e4ce-4fc4-9dfc-09c283c39717","eddedb21-15e2-4b8c-8c52-8da35c1fa494","88228ff5-135d-4f05-a3b5-191fc344b19f","59c11627-77a2-41f9-96b7-6dbe1390f078","8b13ceed-7245-4092-b931-9342b93b41bb","360a9caa-fb14-4c30-907b-ca0372d7d4db","27f7c27f-f0af-4e50-a06c-8fadc997d031","f83447c8-6f17-4c1d-a383-9a29a7ec7293","bec57599-986e-455a-8d17-0d8dfecb85c5","c13bb1ec-8421-412f-a9a8-937dfbb71f87","1105d3f6-66b7-4315-8d47-e0063f7aaefb","1da5924f-b4f7-46ed-bfea-9542ec5e18fe"],"responses":{"200":"2ce3175d-633b-4779-bef9-592ee7259c6b"},"x-availability":"active","method":"get","type":"path","servers":["6cbbafd4-7886-47e6-acbd-67fcccc6e20f"],"security":["64f41989-e9cb-425d-89b0-dad46a40b580"],"path":"/v1/vinted/search","baseUrlOptions":["https://scrapebadger.com"],"title":"Search Items","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"1e0a4b5a-4713-45f5-8581-6925a894be93":{"name":"query","in":"query","required":true,"schema":{"type":"string","isRequired":true,"description":"Search query string. Matches against item titles and descriptions.","uniqueKey":"","typeLabel":"string"},"description":"Search query string. Matches against item titles and descriptions."},"88556621-bd00-488f-83c9-8e05d147c9ee":{"name":"market","in":"query","schema":{"type":"string","default":"fr","description":"Vinted market to search (e.g. fr, de, uk, it, es, pl, us).","uniqueKey":"","typeLabel":"string"},"description":"Vinted market to search (e.g. fr, de, uk, it, es, pl, us)."},"25ebad6b-66bc-4498-98e7-f4d7bf968c3a":{"name":"page","in":"query","schema":{"type":"integer","default":1,"minimum":1,"description":"Page number for paginated results.","uniqueKey":"","typeLabel":"integer"},"description":"Page number for paginated results."},"6f94eeaa-dfa9-4965-a0a0-3b7fad811b2c":{"name":"per_page","in":"query","schema":{"type":"integer","default":20,"minimum":1,"maximum":96,"description":"Number of items per page.","uniqueKey":"","typeLabel":"integer"},"description":"Number of items per page."},"08f11854-e4ce-4fc4-9dfc-09c283c39717":{"name":"price_from","in":"query","schema":{"type":"number","description":"Minimum price filter in the market's local currency.","uniqueKey":"","typeLabel":"number"},"description":"Minimum price filter in the market's local currency."},"eddedb21-15e2-4b8c-8c52-8da35c1fa494":{"name":"price_to","in":"query","schema":{"type":"number","description":"Maximum price filter in the market's local currency.","uniqueKey":"","typeLabel":"number"},"description":"Maximum price filter in the market's local currency."},"88228ff5-135d-4f05-a3b5-191fc344b19f":{"name":"catalog_ids","in":"query","schema":{"type":"string","description":"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.","uniqueKey":"","typeLabel":"string"},"description":"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."},"59c11627-77a2-41f9-96b7-6dbe1390f078":{"name":"brand_ids","in":"query","schema":{"type":"string","description":"Comma-separated list of brand IDs to filter by.","uniqueKey":"","typeLabel":"string"},"description":"Comma-separated list of brand IDs to filter by."},"8b13ceed-7245-4092-b931-9342b93b41bb":{"name":"color_ids","in":"query","schema":{"type":"string","description":"Comma-separated list of color IDs to filter by.","uniqueKey":"","typeLabel":"string"},"description":"Comma-separated list of color IDs to filter by."},"360a9caa-fb14-4c30-907b-ca0372d7d4db":{"name":"status_ids","in":"query","schema":{"type":"string","description":"Comma-separated list of condition status IDs to filter by.","uniqueKey":"","typeLabel":"string"},"description":"Comma-separated list of condition status IDs to filter by."},"27f7c27f-f0af-4e50-a06c-8fadc997d031":{"name":"order","in":"query","schema":{"type":"string","default":"relevance","enum":["relevance","price_low_to_high","price_high_to_low","newest_first"],"description":"Sort order for results.","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"Sort order for results."},"f83447c8-6f17-4c1d-a383-9a29a7ec7293":{"name":"seller_country","in":"query","schema":{"type":"string","description":"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.","uniqueKey":"","typeLabel":"string"},"description":"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."},"bec57599-986e-455a-8d17-0d8dfecb85c5":{"name":"size_ids","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Size Ids","description":"Comma-separated size IDs","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Size Ids","description":"Comma-separated size IDs","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Comma-separated size IDs"},"c13bb1ec-8421-412f-a9a8-937dfbb71f87":{"name":"material_ids","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Material Ids","description":"Comma-separated material IDs","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Material Ids","description":"Comma-separated material IDs","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Comma-separated material IDs"},"1105d3f6-66b7-4315-8d47-e0063f7aaefb":{"name":"time","in":"query","required":false,"schema":{"oneOf":[{"type":"integer","title":"Time","description":"Pagination time returned by the preceding page","minimum":0,"uniqueKey":"oneOf.0","typeLabel":"integer"},{"type":"null","title":"Time","description":"Pagination time returned by the preceding page","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"integer | null"},"description":"Pagination time returned by the preceding page"},"1da5924f-b4f7-46ed-bfea-9542ec5e18fe":{"name":"search_session_id","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Search Session Id","description":"Reuse across pages of one search","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Search Session Id","description":"Reuse across pages of one search","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Reuse across pages of one search"}},"responses":{"2ce3175d-633b-4779-bef9-592ee7259c6b":{"description":"Successful search","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","description":"Item ID.","uniqueKey":"\\items.items.[INDEX].id","typeLabel":"integer"},"title":{"type":"string","description":"Item title.","uniqueKey":"\\items.items.[INDEX].title","typeLabel":"string"},"price":{"type":"object","properties":{"amount":{"type":"string","description":"Decimal amount as a string (e.g. \"45.0\").","uniqueKey":"\\items.items.[INDEX].price.amount","typeLabel":"string"},"currency_code":{"type":"string","description":"ISO 4217 currency code (e.g. \"EUR\").","uniqueKey":"\\items.items.[INDEX].price.currency_code","typeLabel":"string"}},"uniqueKey":"\\items.items.[INDEX].price","typeLabel":"object"},"service_fee":{"oneOf":[{"type":"string","description":"Buyer-protection fee as a decimal string, in price.currency_code.","uniqueKey":"\\items.items.[INDEX].service_fee.oneOf.0","typeLabel":"string"},{"type":"null","description":"Buyer-protection fee as a decimal string, in price.currency_code.","uniqueKey":"\\items.items.[INDEX].service_fee.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].service_fee","typeLabel":"string | null"},"total_item_price":{"oneOf":[{"type":"string","description":"Price + buyer protection as a decimal string, in price.currency_code.","uniqueKey":"\\items.items.[INDEX].total_item_price.oneOf.0","typeLabel":"string"},{"type":"null","description":"Price + buyer protection as a decimal string, in price.currency_code.","uniqueKey":"\\items.items.[INDEX].total_item_price.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].total_item_price","typeLabel":"string | null"},"brand_title":{"oneOf":[{"type":"string","description":"Brand name.","uniqueKey":"\\items.items.[INDEX].brand_title.oneOf.0","typeLabel":"string"},{"type":"null","description":"Brand name.","uniqueKey":"\\items.items.[INDEX].brand_title.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].brand_title","typeLabel":"string | null"},"size_title":{"oneOf":[{"type":"string","description":"Size label.","uniqueKey":"\\items.items.[INDEX].size_title.oneOf.0","typeLabel":"string"},{"type":"null","description":"Size label.","uniqueKey":"\\items.items.[INDEX].size_title.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].size_title","typeLabel":"string | null"},"status":{"oneOf":[{"type":"string","description":"Item condition, localized to the market.","uniqueKey":"\\items.items.[INDEX].status.oneOf.0","typeLabel":"string"},{"type":"null","description":"Item condition, localized to the market.","uniqueKey":"\\items.items.[INDEX].status.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].status","typeLabel":"string | null"},"photo":{"type":"object","properties":{"id":{"type":"integer","description":"Photo ID.","uniqueKey":"\\items.items.[INDEX].photo.id","typeLabel":"integer"},"url":{"type":"string","description":"Photo URL.","uniqueKey":"\\items.items.[INDEX].photo.url","typeLabel":"string"},"full_size_url":{"oneOf":[{"type":"string","description":"Full-resolution photo URL.","uniqueKey":"\\items.items.[INDEX].photo.full_size_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Full-resolution photo URL.","uniqueKey":"\\items.items.[INDEX].photo.full_size_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].photo.full_size_url","typeLabel":"string | null"},"width":{"oneOf":[{"type":"integer","description":"Width in pixels.","uniqueKey":"\\items.items.[INDEX].photo.width.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Width in pixels.","uniqueKey":"\\items.items.[INDEX].photo.width.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].photo.width","typeLabel":"integer | null"},"height":{"oneOf":[{"type":"integer","description":"Height in pixels.","uniqueKey":"\\items.items.[INDEX].photo.height.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Height in pixels.","uniqueKey":"\\items.items.[INDEX].photo.height.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].photo.height","typeLabel":"integer | null"},"dominant_color":{"oneOf":[{"type":"string","description":"Dominant colour as a hex string.","uniqueKey":"\\items.items.[INDEX].photo.dominant_color.oneOf.0","typeLabel":"string"},{"type":"null","description":"Dominant colour as a hex string.","uniqueKey":"\\items.items.[INDEX].photo.dominant_color.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].photo.dominant_color","typeLabel":"string | null"},"is_main":{"type":"boolean","description":"Whether this is the listing's primary photo.","uniqueKey":"\\items.items.[INDEX].photo.is_main","typeLabel":"boolean"}},"uniqueKey":"\\items.items.[INDEX].photo","typeLabel":"object"},"photos":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","description":"Photo ID.","uniqueKey":"\\items.items.[INDEX].photos.items.[INDEX].id","typeLabel":"integer"},"url":{"type":"string","description":"Photo URL.","uniqueKey":"\\items.items.[INDEX].photos.items.[INDEX].url","typeLabel":"string"},"full_size_url":{"oneOf":[{"type":"string","description":"Full-resolution photo URL.","uniqueKey":"\\items.items.[INDEX].photos.items.[INDEX].full_size_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Full-resolution photo URL.","uniqueKey":"\\items.items.[INDEX].photos.items.[INDEX].full_size_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].photos.items.[INDEX].full_size_url","typeLabel":"string | null"},"width":{"oneOf":[{"type":"integer","description":"Width in pixels.","uniqueKey":"\\items.items.[INDEX].photos.items.[INDEX].width.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Width in pixels.","uniqueKey":"\\items.items.[INDEX].photos.items.[INDEX].width.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].photos.items.[INDEX].width","typeLabel":"integer | null"},"height":{"oneOf":[{"type":"integer","description":"Height in pixels.","uniqueKey":"\\items.items.[INDEX].photos.items.[INDEX].height.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Height in pixels.","uniqueKey":"\\items.items.[INDEX].photos.items.[INDEX].height.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].photos.items.[INDEX].height","typeLabel":"integer | null"},"dominant_color":{"oneOf":[{"type":"string","description":"Dominant colour as a hex string.","uniqueKey":"\\items.items.[INDEX].photos.items.[INDEX].dominant_color.oneOf.0","typeLabel":"string"},{"type":"null","description":"Dominant colour as a hex string.","uniqueKey":"\\items.items.[INDEX].photos.items.[INDEX].dominant_color.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].photos.items.[INDEX].dominant_color","typeLabel":"string | null"},"is_main":{"type":"boolean","description":"Whether this is the listing's primary photo.","uniqueKey":"\\items.items.[INDEX].photos.items.[INDEX].is_main","typeLabel":"boolean"}},"uniqueKey":"\\items.items.[INDEX].photos.items.[INDEX]","typeLabel":"object"},"uniqueKey":"\\items.items.[INDEX].photos","typeLabel":"object[]"},"url":{"type":"string","description":"Full URL to the Vinted listing.","uniqueKey":"\\items.items.[INDEX].url","typeLabel":"string"},"path":{"oneOf":[{"type":"string","description":"Path portion of the listing URL.","uniqueKey":"\\items.items.[INDEX].path.oneOf.0","typeLabel":"string"},{"type":"null","description":"Path portion of the listing URL.","uniqueKey":"\\items.items.[INDEX].path.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].path","typeLabel":"string | null"},"user":{"type":"object","properties":{"id":{"type":"integer","description":"User ID.","uniqueKey":"\\items.items.[INDEX].user.id","typeLabel":"integer"},"login":{"type":"string","description":"Username.","uniqueKey":"\\items.items.[INDEX].user.login","typeLabel":"string"},"photo_url":{"oneOf":[{"type":"string","description":"Profile photo URL.","uniqueKey":"\\items.items.[INDEX].user.photo_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Profile photo URL.","uniqueKey":"\\items.items.[INDEX].user.photo_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].user.photo_url","typeLabel":"string | null"},"business":{"type":"boolean","description":"Whether the seller is a business account.","uniqueKey":"\\items.items.[INDEX].user.business","typeLabel":"boolean"}},"uniqueKey":"\\items.items.[INDEX].user","typeLabel":"object"},"favourite_count":{"type":"integer","description":"Number of users who favourited this item.","uniqueKey":"\\items.items.[INDEX].favourite_count","typeLabel":"integer"},"view_count":{"type":"integer","description":"Number of views.","uniqueKey":"\\items.items.[INDEX].view_count","typeLabel":"integer"},"is_visible":{"type":"boolean","description":"Whether the listing is publicly visible.","uniqueKey":"\\items.items.[INDEX].is_visible","typeLabel":"boolean"},"promoted":{"type":"boolean","description":"Whether the listing is a promoted/bumped placement.","uniqueKey":"\\items.items.[INDEX].promoted","typeLabel":"boolean"},"content_source":{"oneOf":[{"type":"string","description":"Vinted's own label for where the result came from (e.g. \"search\").","uniqueKey":"\\items.items.[INDEX].content_source.oneOf.0","typeLabel":"string"},{"type":"null","description":"Vinted's own label for where the result came from (e.g. \"search\").","uniqueKey":"\\items.items.[INDEX].content_source.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].content_source","typeLabel":"string | null"},"seller_country_code":{"oneOf":[{"type":"string","description":"ISO 3166-1 alpha-2 code of the seller's physical country (e.g. \"IT\"). Populated only when seller_country filtering was requested.","uniqueKey":"\\items.items.[INDEX].seller_country_code.oneOf.0","typeLabel":"string"},{"type":"null","description":"ISO 3166-1 alpha-2 code of the seller's physical country (e.g. \"IT\"). Populated only when seller_country filtering was requested.","uniqueKey":"\\items.items.[INDEX].seller_country_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].seller_country_code","typeLabel":"string | null"},"display_title":{"oneOf":[{"type":"string","description":"Vinted display text; do not interpret it as a brand or size ID.","uniqueKey":"\\items.items.[INDEX].display_title.oneOf.0","typeLabel":"string"},{"type":"null","description":"Vinted display text; do not interpret it as a brand or size ID.","uniqueKey":"\\items.items.[INDEX].display_title.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].display_title","typeLabel":"string | null"},"display_subtitle":{"oneOf":[{"type":"string","description":"Vinted display text; do not interpret it as a brand or size ID.","uniqueKey":"\\items.items.[INDEX].display_subtitle.oneOf.0","typeLabel":"string"},{"type":"null","description":"Vinted display text; do not interpret it as a brand or size ID.","uniqueKey":"\\items.items.[INDEX].display_subtitle.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].display_subtitle","typeLabel":"string | null"},"similarity_score":{"oneOf":[{"type":"number","description":"Visual similarity to the query image, 0-1, where the query image's own listing scores 1.0. Populated only by search_by_image, and only on the calls where Vinted returns a ranking; null otherwise. A null says nothing about the item, only that Vinted sent no score.","uniqueKey":"\\items.items.[INDEX].similarity_score.oneOf.0","typeLabel":"number"},{"type":"null","description":"Visual similarity to the query image, 0-1, where the query image's own listing scores 1.0. Populated only by search_by_image, and only on the calls where Vinted returns a ranking; null otherwise. A null says nothing about the item, only that Vinted sent no score.","uniqueKey":"\\items.items.[INDEX].similarity_score.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].similarity_score","typeLabel":"number | null"}},"uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"uniqueKey":"\\items","typeLabel":"object[]"},"pagination":{"type":"object","properties":{"current_page":{"type":"integer","description":"Current page number.","uniqueKey":"pagination.current_page","typeLabel":"integer"},"per_page":{"type":"integer","description":"Number of items per page.","uniqueKey":"pagination.per_page","typeLabel":"integer"},"total_pages":{"type":"integer","description":"Total number of pages.","uniqueKey":"pagination.total_pages","typeLabel":"integer"},"total_entries":{"type":"integer","description":"Total matching items. Vinted caps this at 960 on deep result sets — treat it as an upper bound.","uniqueKey":"pagination.total_entries","typeLabel":"integer"},"time":{"oneOf":[{"type":"integer","description":"Pass unchanged into the next catalog page request.","uniqueKey":"pagination.time.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Pass unchanged into the next catalog page request.","uniqueKey":"pagination.time.oneOf.1","typeLabel":"null"}],"uniqueKey":"pagination.time","typeLabel":"integer | null"}},"uniqueKey":"pagination","typeLabel":"object"},"market":{"type":"string","description":"Echo of the market that was searched.","uniqueKey":"market","typeLabel":"string"},"seller_country":{"oneOf":[{"type":"string","description":"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.","uniqueKey":"seller_country.oneOf.0","typeLabel":"string"},{"type":"null","description":"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.","uniqueKey":"seller_country.oneOf.1","typeLabel":"null"}],"uniqueKey":"seller_country","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"items":[{"id":123,"title":"\u003cstring>","price":{"amount":"\u003cstring>","currency_code":"\u003cstring>"},"service_fee":"\u003cstring>","total_item_price":"\u003cstring>","brand_title":"\u003cstring>","size_title":"\u003cstring>","status":"\u003cstring>","photo":{"id":123,"url":"\u003cstring>","full_size_url":"\u003cstring>","width":123,"height":123,"dominant_color":"\u003cstring>","is_main":true},"photos":[{"id":123,"url":"\u003cstring>","full_size_url":"\u003cstring>","width":123,"height":123,"dominant_color":"\u003cstring>","is_main":true}],"url":"\u003cstring>","path":"\u003cstring>","user":{"id":123,"login":"\u003cstring>","photo_url":"\u003cstring>","business":true},"favourite_count":123,"view_count":123,"is_visible":true,"promoted":true,"content_source":"\u003cstring>","seller_country_code":"\u003cstring>","display_title":"\u003cstring>","display_subtitle":"\u003cstring>","similarity_score":123}],"pagination":{"current_page":123,"per_page":123,"total_pages":123,"total_entries":123,"time":123},"market":"\u003cstring>","seller_country":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"64f41989-e9cb-425d-89b0-dad46a40b580":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"apiKeyAuth"}}},"servers":{"6cbbafd4-7886-47e6-acbd-67fcccc6e20f":{"url":"https://scrapebadger.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"apiKeyAuth"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"x-api-key"}],"title":"apiKeyAuth"}]},"originalFileLocation":"openapi-vinted.json"},"subdomain":"scrapebadger","siteName":"ScrapeBadger","title":"Search Items - ScrapeBadger","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T10:30:11.880Z","originalFileLocation":"api-reference/endpoint/vinted/search-items.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Search Vinted catalog items with filters.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ScrapeBadger\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Search Items - ScrapeBadger\">\u003cmeta data-mint-head property=\"og:description\" content=\"Search Vinted catalog items with filters.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ScrapeBadger\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.scrapebadger.com/api-reference/endpoint/vinted/search-items\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://scrapebadger.mintlify.site/_mintlify/api/og/v2?division=Search\u0026amp;title=Search+Items\u0026amp;description=Search+Vinted+catalog+items+with+filters.\u0026amp;theme=c13b03cf41cd0fda854fce47\u0026amp;signature=c33d8a337f430a56c982d6b007571d4a5c2832623d5dc19972acff4622b231d6\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Search Items - ScrapeBadger\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Search Vinted catalog items with filters.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://scrapebadger.mintlify.site/_mintlify/api/og/v2?division=Search\u0026amp;title=Search+Items\u0026amp;description=Search+Vinted+catalog+items+with+filters.\u0026amp;theme=c13b03cf41cd0fda854fce47\u0026amp;signature=c33d8a337f430a56c982d6b007571d4a5c2832623d5dc19972acff4622b231d6\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/scrapebadger/B7QFAHnHtKjf5kVI/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ScrapeBadger\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.scrapebadger.com/api-reference/endpoint/vinted/search-items\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/vinted/search-items.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.scrapebadger.com/#organization\",\"name\":\"ScrapeBadger\",\"url\":\"https://docs.scrapebadger.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/scrapebadger/gnGR4eL2rEJ4E7w3/logo/light.png?fit=max\u0026auto=format\u0026n=gnGR4eL2rEJ4E7w3\u0026q=85\u0026s=d393e30b48870f8495f788d1fad76ad3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.scrapebadger.com#website\",\"name\":\"ScrapeBadger\",\"url\":\"https://docs.scrapebadger.com\",\"publisher\":{\"@id\":\"https://docs.scrapebadger.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.scrapebadger.com/api-reference/endpoint/vinted/search-items#webpage\",\"url\":\"https://docs.scrapebadger.com/api-reference/endpoint/vinted/search-items\",\"name\":\"Search Items\",\"description\":\"Search Vinted catalog items with filters.\",\"dateModified\":\"2026-11-12T10:30:11.880Z\",\"isPartOf\":{\"@id\":\"https://docs.scrapebadger.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.scrapebadger.com/api-reference/endpoint/vinted/search-items#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.scrapebadger.com/api-reference/endpoint/vinted/search-items#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"ScrapeBadger\",\"item\":\"https://docs.scrapebadger.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Search Items\",\"item\":\"https://docs.scrapebadger.com/api-reference/endpoint/vinted/search-items\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.scrapebadger.com/api-reference/endpoint/vinted/search-items#apireference\",\"headline\":\"Search Items\",\"name\":\"Search Items\",\"description\":\"Search Vinted catalog items with filters.\",\"url\":\"https://docs.scrapebadger.com/api-reference/endpoint/vinted/search-items\",\"mainEntityOfPage\":{\"@id\":\"https://docs.scrapebadger.com/api-reference/endpoint/vinted/search-items#webpage\"},\"dateModified\":\"2026-11-12T10:30:11.880Z\",\"publisher\":{\"@id\":\"https://docs.scrapebadger.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.scrapebadger.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ScrapeBadger\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ScrapeBadger\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/endpoint/vinted/search-items.md","siteName":"ScrapeBadger","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"gauge","href":"https://scrapebadger.com/dashboard?utm_source=docs\u0026utm_medium=referral"},{"anchor":"Pricing","icon":"credit-card","href":"https://scrapebadger.com/pricing"}]},"tabs":[{"tab":"Getting Started","pages":[{"title":"Getting Started","href":""}]},{"tab":"Web Scraping","pages":[{"title":"Web Scraping","href":"/web-scraping/overview"}]},{"tab":"Google","pages":[{"title":"Google","href":"/google/overview"}]},{"tab":"Baidu","pages":[{"title":"Baidu","href":"/baidu/overview"}]},{"tab":"Bing","pages":[{"title":"Bing","href":"/bing/overview"}]},{"tab":"DuckDuckGo","pages":[{"title":"DuckDuckGo","href":"/duckduckgo/overview"}]},{"tab":"Yahoo","pages":[{"title":"Yahoo","href":"/yahoo/overview"}]},{"tab":"Yandex","pages":[{"title":"Yandex","href":"/yandex/overview"}]},{"tab":"Naver","pages":[{"title":"Naver","href":"/naver/overview"}]},{"tab":"Reddit","pages":[{"title":"Reddit","href":"/reddit/overview"}]},{"tab":"Vinted","groups":[{"group":"Overview","pages":[{"title":"Vinted Scraper API — Overview","href":"/vinted/overview"}]},{"group":"Mobile data","pages":[{"title":"Vinted mobile data","href":"/vinted/mobile-api"},{"title":"List mobile operations","openapi":"GET /v1/vinted/mobile/operations","href":"/api-reference/endpoint/vinted/mobile-operations"},{"title":"Read mobile data","openapi":"POST /v1/vinted/mobile/{operation}","description":"Read public Vinted data, including sold comparables, pricing, reviews, categories and shipping references.","href":"/api-reference/endpoint/vinted/mobile-read"}]},{"group":"Search","pages":[{"title":"Search Items","openapi":"GET /v1/vinted/search","href":"/api-reference/endpoint/vinted/search-items"},{"title":"Vinted Image Search","description":"Find visually similar active Vinted listings from an image URL, base64 photo or local file.","href":"/vinted/image-search"},{"title":"Search by Image","openapi":"POST /v1/vinted/search_by_image","href":"/api-reference/endpoint/vinted/search-by-image"}]},{"group":"Items","pages":[{"title":"Get Item Details","openapi":"GET /v1/vinted/items/{item_id}","href":"/api-reference/endpoint/vinted/get-item-detail"}]},{"group":"Sellers","pages":[{"title":"Get User Profile","openapi":"GET /v1/vinted/users/{user_id}","href":"/api-reference/endpoint/vinted/get-user-profile"},{"title":"Get User Items","openapi":"GET /v1/vinted/users/{user_id}/items","href":"/api-reference/endpoint/vinted/get-user-items"}]},{"group":"Reference","pages":[{"title":"Search Brands","openapi":"GET /v1/vinted/brands","href":"/api-reference/endpoint/vinted/search-brands"},{"title":"List Colors","openapi":"GET /v1/vinted/colors","href":"/api-reference/endpoint/vinted/list-colors"},{"title":"List Conditions","openapi":"GET /v1/vinted/statuses","href":"/api-reference/endpoint/vinted/list-statuses"},{"title":"List Markets","openapi":"GET /v1/vinted/markets","href":"/api-reference/endpoint/vinted/list-markets"}]}]},{"tab":"Depop","pages":[{"title":"Depop","href":"/depop/overview"}]},{"tab":"Wallapop","pages":[{"title":"Wallapop","href":"/wallapop/overview"}]},{"tab":"LinkedIn","pages":[{"title":"LinkedIn","href":"/linkedin/overview"}]},{"tab":"Amazon","pages":[{"title":"Amazon","href":"/amazon/overview"}]},{"tab":"eBay","pages":[{"title":"eBay","href":"/ebay/overview"}]},{"tab":"Walmart","pages":[{"title":"Walmart","href":"/walmart/overview"}]},{"tab":"Google Play","pages":[{"title":"Google Play","href":"/google-play/overview"}]},{"tab":"App Store","pages":[{"title":"App Store","href":"/app-store/overview"}]},{"tab":"Leboncoin","pages":[{"title":"Leboncoin","href":"/leboncoin/overview"}]},{"tab":"Gumtree","pages":[{"title":"Gumtree","href":"/gumtree/overview"}]},{"tab":"Immobiliare","pages":[{"title":"Immobiliare","href":"/immobiliare/overview"}]},{"tab":"LoopNet","pages":[{"title":"LoopNet","href":"/loopnet/overview"}]},{"tab":"Airbnb","pages":[{"title":"Airbnb","href":"/airbnb/overview"}]},{"tab":"Booking.com","pages":[{"title":"Booking.com","href":"/booking/overview"}]},{"tab":"Apartments.com","pages":[{"title":"Apartments.com","href":"/apartments/overview"}]},{"tab":"Realtor","pages":[{"title":"Realtor","href":"/realtor/overview"}]},{"tab":"Zillow","pages":[{"title":"Zillow","href":"/zillow/overview"}]},{"tab":"YouTube","pages":[{"title":"YouTube","href":"/youtube/overview"}]},{"tab":"Instagram","pages":[{"title":"Instagram","href":"/instagram/overview"}]},{"tab":"Facebook","pages":[{"title":"Facebook","href":"/facebook/overview"}]},{"tab":"TikTok","pages":[{"title":"TikTok","href":"/tiktok/overview"}]},{"tab":"Twitter","pages":[{"title":"Twitter","href":"/api-reference/introduction"}]},{"tab":"ChatGPT","pages":[{"title":"ChatGPT","href":"/chatgpt/overview"}]},{"tab":"Grok","pages":[{"title":"Grok","href":"/grok/overview"}]},{"tab":"Amazon Rufus","pages":[{"title":"Amazon Rufus","href":"/rufus/overview"}]},{"tab":"Meta AI","pages":[{"title":"Meta AI","href":"/meta-ai/overview"}]},{"tab":"Gemini","pages":[{"title":"Gemini","href":"/gemini/overview"}]},{"tab":"Perplexity","pages":[{"title":"Perplexity","href":"/api-reference/endpoint/perplexity/ask"}]},{"tab":"Copilot","pages":[{"title":"Copilot","href":"/copilot/overview"}]},{"tab":"MCP Server","pages":[{"title":"MCP Server","href":"/mcp/overview"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli/overview"}]},{"tab":"ASOS","pages":[{"title":"ASOS","href":"/asos/overview"}]},{"tab":"Target","pages":[{"title":"Target","href":"/target/overview"}]},{"tab":"Etsy","pages":[{"title":"Etsy","href":"/etsy/overview"}]},{"tab":"AliExpress","pages":[{"title":"AliExpress","href":"/aliexpress/overview"}]},{"tab":"Best Buy","pages":[{"title":"Best Buy","href":"/bestbuy/overview"}]},{"tab":"GitHub","pages":[{"title":"GitHub","href":"/github/overview"}]},{"tab":"AutoScout24","pages":[{"title":"AutoScout24","href":"/autoscout24/overview"}]},{"tab":"Brave","pages":[{"title":"Brave","href":"/brave/overview"}]},{"tab":"Yelp","pages":[{"title":"Yelp","href":"/yelp/overview"}]}]},"basePath":"","title":"Search Items - ScrapeBadger","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}