> ## Documentation Index > Fetch the complete documentation index at: https://docs.perceptlayer.com/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Perceptlayer is a web data API: one key for structured JSON from about 250 websites. Base URL https://api.perceptlayer.com. > Send the key in the X-API-Key header. GET parameters go in the query string; POST parameters in a JSON body. > A successful call costs the credits on its endpoint (X-Credits-Used); failed calls cost nothing. Errors are {"error": {"code", "message", "request_id"}}. > AI agents can use every endpoint through the MCP server at https://api.perceptlayer.com/mcp (tools search_endpoints, get_endpoint, call_endpoint), with Authorization: Bearer . > Get a free key at https://perceptlayer.com/signup. # Vinted: Search > Search from Vinted. Costs 1 credit per successful call. 1 credit per successful call; failed calls are free. See the [Vinted API overview](https://perceptlayer.com/apis/vinted) for every Vinted endpoint. ## OpenAPI ````yaml /openapi.json get /v1/vinted/search openapi: 3.1.0 info: title: Perceptlayer API version: 1.0.0 description: >- One API key for structured web data. Each successful call costs the credits shown on its endpoint; failed calls are free. servers: - url: https://api.perceptlayer.com security: - ApiKeyAuth: [] tags: - name: 99acres - name: Agoda - name: Airbnb - name: AliExpress - name: Apartments.com - name: Apple App Store - name: Aramisauto - name: Arbeitsagentur Jobs - name: Argenprop - name: Autohero - name: AutoScout24 - name: AutoTempest - name: AutoTrack.nl - name: Autotrader - name: AutoTrader.ca - name: AutoTrader UK - name: AutoUncle - name: Autovit - name: Baidu - name: Bandcamp - name: Bayut - name: Behance - name: Bien'ici - name: Bilbasen - name: Bilibili - name: Billiger.de - name: Bing - name: Blocket Bil - name: Bluesky - name: Boliga - name: Booking.com - name: Booli - name: Brave Search - name: Bring a Trailer - name: Capterra - name: CarDekho - name: CarGurus - name: CarMax - name: Cars & Bids - name: Cars.com - name: Cars24 - name: Carsales - name: Carvana - name: Carwow - name: Casa.it - name: Centris - name: Coches.net - name: Copart - name: Craigslist - name: Crexi - name: Daft.ie - name: Dailymotion - name: DBA - name: Depop - name: DeviantArt - name: Dice - name: Domain Availability - name: Domain.com.au - name: Dribbble - name: Dubizzle - name: DuckDuckGo - name: eBay - name: Economy Car Rentals - name: Edmunds - name: Eventbrite - name: Expedia - name: Facebook - name: Facebook Ad Library - name: Fincaraiz - name: FINN - name: FINN Bil - name: Flickr - name: FlixBus - name: Fotocasa - name: Geizhals - name: Genius - name: GetYourGuide - name: GitHub - name: Glassdoor - name: Goodreads - name: Google Ads Transparency - name: Google Events - name: Google Finance - name: Google Flights - name: Google Forums - name: Google Hotels - name: Google Images - name: Google Jobs - name: Google Lens - name: Google Local - name: Google Local Services - name: Google Maps - name: Google News - name: Google Patents - name: Google Play - name: Google Related Questions - name: Google Scholar - name: Google Search - name: Google Shopping - name: Google Short Videos - name: Google Translate - name: Google Travel Explore - name: Google Trends - name: Google Videos - name: Gumtree - name: Habitaclia - name: Hacker News - name: Hemnet - name: heycar - name: HolidayCheck - name: Holidu - name: Homegate - name: HomeToGo - name: Hostelworld - name: HotPads - name: IAAI - name: Idealista - name: Idealo - name: Imgur - name: ImmobilienScout24 - name: ImmobilienScout24 Austria - name: ImmoScout24 Switzerland - name: Immoweb - name: Immowelt - name: Imovirtual - name: Impressum Extraction - name: Indeed - name: InfoJobs - name: Inmuebles24 - name: Instagram - name: Jameda - name: Kavak - name: Kayak Flights - name: Kayak - name: Kelley Blue Book - name: Kick - name: Kijiji - name: Kiwi.com - name: Kleinanzeigen - name: kununu - name: Kwai - name: La Centrale - name: Leboncoin Autos - name: Leboncoin Immo - name: Lemmy - name: Letterboxd - name: Link in Bio - name: LinkedIn - name: Linktree - name: LLM Answers - name: LoopNet - name: Madlan - name: MagicBricks - name: Marktplaats - name: Marktplaats Autos - name: Mastodon - name: Medium - name: Mercado Libre - name: Metrocuadrado - name: Milanuncios - name: Mixcloud - name: mobile.de - name: Motors.co.uk - name: MyAnimeList - name: Naukri - name: Naver - name: North Data - name: Odysee - name: OfferUp - name: Ohne-Makler - name: OLX Poland - name: Omio - name: OnTheMarket - name: Otodom - name: Otomoto - name: Patreon - name: Pinterest - name: Private Property - name: Product Hunt - name: Property Finder - name: realestate.com.au - name: Realtor.ca - name: Redfin - name: Reed - name: Rentalcars.com - name: Rentalia - name: Ricardo - name: Rightmove - name: Rumble - name: SEEK - name: SeLoger - name: Semrush - name: Similarweb - name: Skyscanner - name: Snapchat - name: SoundCloud - name: SpareRoom - name: Spotahome - name: Spotify - name: Sreality - name: Standvirtual - name: Startpage - name: Steam - name: StepStone - name: Subito - name: Subito Motori - name: Substack - name: SuperCasa - name: Telegram - name: Threads - name: TikTok - name: Trade Me Property - name: Trainline - name: Tripadvisor - name: Trivago - name: TrueCar - name: Trulia - name: Trusted Shops - name: Trustpilot - name: Truth Social - name: Tumblr - name: tutti.ch - name: Twitch - name: Viator - name: Vimeo - name: Vinted - name: VivaReal - name: VK - name: Vrbo - name: Wallapop - name: Walmart - name: Web Scraper - name: Weibo - name: Welcome to the Jungle - name: WG-Gesucht - name: willhaben - name: wlw - name: X (Twitter) - name: XING Jobs - name: Yad2 - name: Yaencontre - name: Yahoo Search - name: Yelp - name: YouTube - name: Zillow - name: Zonaprop - name: Zoopla - name: Zumper paths: /v1/vinted/search: get: tags: - Vinted summary: Search description: Search from Vinted. Costs 1 credit per successful call. operationId: vinted_search parameters: - name: q in: query required: false schema: type: string maxLength: 500 - name: query in: query required: false schema: type: string maxLength: 500 example: nike shoes - name: page in: query required: false schema: type: integer - name: per_page in: query required: false schema: type: integer - name: order in: query required: false schema: type: string enum: - relevance - newest_first - price_low_to_high - price_high_to_low - name: brand_ids in: query required: false schema: type: string maxLength: 500 - name: catalog_ids in: query required: false schema: type: string maxLength: 500 - name: color_ids in: query required: false schema: type: string maxLength: 200 - name: size_ids in: query required: false schema: type: string maxLength: 200 - name: material_ids in: query required: false schema: type: string maxLength: 200 - name: status_ids in: query required: false schema: type: string maxLength: 100 - name: price_from in: query required: false schema: type: number - name: price_to in: query required: false schema: type: number - name: country in: query required: false schema: type: string enum: - FR - DE - ES - IT - NL - BE - AT - PL - CZ - LT - LU - SK - HU - RO - PT - SE - DK - FI - US maxLength: 2 example: DE responses: '200': description: Success headers: X-Request-Id: $ref: '#/components/headers/RequestId' X-Credits-Used: $ref: '#/components/headers/CreditsUsed' X-Credits-Remaining: $ref: '#/components/headers/CreditsRemaining' RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' RateLimit-Policy: $ref: '#/components/headers/RateLimitPolicy' content: application/json: schema: type: object properties: endpoint: type: string params: type: object properties: query: type: string country: type: string response: type: object properties: success: type: boolean data: type: object properties: items: type: array items: type: object properties: content_source: type: string favourite_count: type: integer id: type: integer is_favourite: type: boolean item_box: type: object properties: accessibility_label: type: string first_line: type: string item_id: type: integer second_line: type: string photo: type: object properties: dominant_color: type: string dominant_color_opaque: type: string full_size_url: type: string height: type: integer high_resolution: type: object properties: id: type: string id: type: integer image_no: type: integer is_main: type: boolean thumbnails: type: array items: type: string url: type: string width: type: integer photos: type: array items: type: object properties: dominant_color: type: string dominant_color_opaque: type: string full_size_url: type: string height: type: integer high_resolution: type: string id: type: integer image_no: type: integer is_main: type: boolean thumbnails: type: array items: type: string url: type: string width: type: integer price: type: object properties: amount: type: string currency_code: type: string promoted: type: boolean search_tracking_params: type: object properties: score: type: number service_fee: type: object properties: amount: type: string currency_code: type: string show_1st_time_seller_discount: type: boolean title: type: string total_item_price: type: object properties: amount: type: string currency_code: type: string url: type: string user: type: object properties: business: type: boolean id: type: integer login: type: string view_count: type: integer pagination: type: object properties: current_page: type: integer per_page: type: integer time: type: integer total_entries: type: integer total_pages: type: integer search_tracking_params: type: object properties: global_search_session_id: type: string search_correlation_id: type: string search_session_id: type: string message: type: string meta: type: object properties: duration_ms: type: number scraped_at: type: string description: >- The fields of a recorded response. Other responses can carry more, or leave some out. example: endpoint: vinted.search params: query: nike shoes country: DE response: success: true data: items: - content_source: search favourite_count: 66 id: 10490818547 is_favourite: false item_box: accessibility_label: >- Nikeshoe size 38.5, Marke: Nike, Zustand: Sehr gut, Größe: 38.5, 20.00 €, 21.70 € first_line: Nike item_id: 10490818547 second_line: 38.5 · Sehr gut photo: dominant_color: '#D9B6C0' dominant_color_opaque: '#F4E9EC' full_size_url: >- https://images1.vinted.net/tc/06_00853_fZcSGhpcLtP5zySfYRu7MUL7/be5ef36b.webp?s=3ac9498086b844e3d35897765db6abb56f4c7346 height: 600 high_resolution: id: 06_00853_fZcSGhpcLtP5zySfYRu7MUL7 id: 1 image_no: 1 is_main: true thumbnails: - … - … - … url: >- https://images1.vinted.net/t/06_00853_fZcSGhpcLtP5zySfYRu7MUL7/f800/be5ef36b.webp?s=07ca3aadced617fbc62ea078802f85105811eab6 width: 800 photos: - dominant_color: '#D9B6C0' dominant_color_opaque: '#F4E9EC' full_size_url: >- https://images1.vinted.net/tc/06_00853_fZcSGhpcLtP5zySfYRu7MUL7/be5ef36b.webp?s=3ac9498086b844e3d35897765db6abb56f4c7346 height: 600 high_resolution: … id: 1 image_no: 1 is_main: true thumbnails: - … - … - … url: >- https://images1.vinted.net/t/06_00853_fZcSGhpcLtP5zySfYRu7MUL7/f800/be5ef36b.webp?s=07ca3aadced617fbc62ea078802f85105811eab6 width: 800 price: amount: '20.00' currency_code: EUR promoted: false search_tracking_params: score: 1 service_fee: amount: '1.70' currency_code: EUR show_1st_time_seller_discount: false title: Nikeshoe size 38.5 total_item_price: amount: '21.70' currency_code: EUR url: /items/10490818547-nikeshoe-size-385 user: business: false id: 3185644359 login: joyc334 view_count: 0 - content_source: search_promoted_items favourite_count: 40 id: 10182967081 is_favourite: false item_box: accessibility_label: >- Nike Kids Shoes, Marke: Nike, Zustand: Neu, ohne Etikett, Größe: 21, 15.00 €, 16.45 € first_line: Nike item_id: 10182967081 second_line: 21 · Neu, ohne Etikett photo: dominant_color: '#542C22' dominant_color_opaque: '#CCC0BD' full_size_url: >- https://images1.vinted.net/tc/02_01cab_qb2JsFVAeRX5cLdhTth85tbE/8d58e54d.webp?s=f13393a91526c93e116cf1ca9f690b76c12aef7a height: 800 high_resolution: id: 02_01cab_qb2JsFVAeRX5cLdhTth85tbE id: 1 image_no: 1 is_main: true thumbnails: - … - … - … url: >- https://images1.vinted.net/t/02_01cab_qb2JsFVAeRX5cLdhTth85tbE/f800/8d58e54d.webp?s=0d14c907b22db88b097584df90f6d660ddc743f6 width: 600 photos: - dominant_color: '#542C22' dominant_color_opaque: '#CCC0BD' full_size_url: >- https://images1.vinted.net/tc/02_01cab_qb2JsFVAeRX5cLdhTth85tbE/8d58e54d.webp?s=f13393a91526c93e116cf1ca9f690b76c12aef7a height: 800 high_resolution: … id: 1 image_no: 1 is_main: true thumbnails: - … - … - … url: >- https://images1.vinted.net/t/02_01cab_qb2JsFVAeRX5cLdhTth85tbE/f800/8d58e54d.webp?s=0d14c907b22db88b097584df90f6d660ddc743f6 width: 600 price: amount: '15.00' currency_code: EUR promoted: true search_tracking_params: score: 1 service_fee: amount: '1.45' currency_code: EUR show_1st_time_seller_discount: false title: Nike Kids Shoes total_item_price: amount: '16.45' currency_code: EUR url: /items/10182967081-nike-kids-shoes user: business: false id: 3184878342 login: tommyjunior25 view_count: 0 - content_source: search_promoted_items favourite_count: 3 id: 10502275133 is_favourite: false item_box: accessibility_label: >- Nike Structure 26 hardloopschoenen zwart, Marke: Nike, Zustand: Neu, ohne Etikett, Größe: 46, 30.00 €, 32.20 € first_line: Nike item_id: 10502275133 second_line: 46 · Neu, ohne Etikett photo: dominant_color: '#4A4A47' dominant_color_opaque: '#C9C9C8' full_size_url: >- https://images1.vinted.net/tc/02_02441_iR4jfMoNEeoH7a8bT4XPFzJo/ed6537be.webp?s=8cd3ae204cfa6473c9a8a94d3293aff258444f9b height: 800 high_resolution: id: 02_02441_iR4jfMoNEeoH7a8bT4XPFzJo id: 1 image_no: 1 is_main: true thumbnails: - … - … - … url: >- https://images1.vinted.net/t/02_02441_iR4jfMoNEeoH7a8bT4XPFzJo/f800/ed6537be.webp?s=daead588a9647de6fda826dfce5bc4aa6b767f0a width: 600 photos: - dominant_color: '#4A4A47' dominant_color_opaque: '#C9C9C8' full_size_url: >- https://images1.vinted.net/tc/02_02441_iR4jfMoNEeoH7a8bT4XPFzJo/ed6537be.webp?s=8cd3ae204cfa6473c9a8a94d3293aff258444f9b height: 800 high_resolution: … id: 1 image_no: 1 is_main: true thumbnails: - … - … - … url: >- https://images1.vinted.net/t/02_02441_iR4jfMoNEeoH7a8bT4XPFzJo/f800/ed6537be.webp?s=daead588a9647de6fda826dfce5bc4aa6b767f0a width: 600 price: amount: '30.00' currency_code: EUR promoted: true search_tracking_params: score: 0.9999989867210388 service_fee: amount: '2.20' currency_code: EUR show_1st_time_seller_discount: false title: Nike Structure 26 hardloopschoenen zwart total_item_price: amount: '32.20' currency_code: EUR url: >- /items/10502275133-nike-structure-26-hardloopschoenen-zwart user: business: false id: 248727077 login: merkkleding02 view_count: 0 pagination: current_page: 1 per_page: 24 time: 1792788799 total_entries: 960 total_pages: 40 search_tracking_params: global_search_session_id: edc95c1f-1f58-4b19-88e4-be4683bddd94 search_correlation_id: 1cae4ec8-0d3c-42f0-a6c9-3f54d1c42316 search_session_id: 80f82f94-26c1-4c7b-bc0d-3b971e7fa885 message: Items retrieved successfully meta: duration_ms: 3772.52 scraped_at: '2026-10-23T20:53:19.928683Z' '401': $ref: '#/components/responses/Error' '402': $ref: '#/components/responses/Error' '403': $ref: '#/components/responses/Error' '404': $ref: '#/components/responses/Error' '410': $ref: '#/components/responses/Error' '422': $ref: '#/components/responses/Error' '429': $ref: '#/components/responses/Error' '502': $ref: '#/components/responses/Error' '503': $ref: '#/components/responses/Error' '504': $ref: '#/components/responses/Error' components: headers: RequestId: description: Unique ID for this request; quote it in support requests. schema: type: string CreditsUsed: description: Credits charged for this call (0 when it failed). schema: type: integer CreditsRemaining: description: Your balance after this call. schema: type: integer RateLimitLimit: description: >- Requests a minute your account may make: its rate in requests per second times 60. schema: type: integer RateLimitRemaining: description: Requests left in the current minute, shared by every key on the account. schema: type: integer RateLimitReset: description: Seconds until the current minute's count starts over. schema: type: integer RateLimitPolicy: description: The limit and its window in seconds, for example "300;w=60". schema: type: string responses: Error: description: Error content: application/json: schema: $ref: '#/components/schemas/Error' schemas: Error: type: object required: - error properties: error: type: object required: - code - message - request_id properties: code: type: string message: type: string request_id: type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.