> ## 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. # Idealo: Search > Search from Idealo. Costs 1 credit per successful call. 1 credit per successful call; failed calls are free. See the [Idealo API overview](https://perceptlayer.com/apis/idealo) for every Idealo endpoint. ## OpenAPI ````yaml /openapi.json get /v1/idealo/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/idealo/search: get: tags: - Idealo summary: Search description: Search from Idealo. Costs 1 credit per successful call. operationId: idealo_search parameters: - name: query in: query required: false schema: type: string maxLength: 200 - name: category_id in: query required: false schema: type: string - name: page in: query required: false schema: type: integer - name: sort in: query required: false schema: type: string enum: - RELEVANCE_DESC - PRICE_ASC - PRICE_DESC - DISCOUNT_DESC - CREATION_DATE_DESC - name: filters[] in: query required: false schema: type: array items: type: string - name: item_states[] in: query required: false schema: type: array items: type: string enum: - BARGAIN - SHORT_TERM_BARGAIN - EXCLUDE_USED - FAST_DELIVERABLE - name: price_min in: query required: false schema: type: number - name: price_max in: query required: false schema: type: number 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 response: type: object properties: success: type: boolean query: type: string category_id: type: string sort: type: string results: type: array items: type: object properties: id: type: string type: type: string title: type: string subheading: type: string characteristics: type: array items: type: string category_id: type: string url: type: string image_url: type: string price: type: integer price_formatted: type: string currency: type: string offer_count: type: integer used_only: type: boolean rating: type: object properties: user_review_count: type: integer score_percent: type: integer test_rating: type: string cheapest_offer: type: object properties: offer_key: type: string shop_id: type: string shop_name: type: string shop_logo_url: type: string is_merchant: type: boolean shipping_costs: type: string shipping_is_free: type: boolean voucher: type: object properties: {} is_bestseller: type: boolean bestseller_info: type: object properties: rank: type: integer has_pros_and_cons: type: boolean is_sponsored: type: boolean facets: type: array items: type: object properties: id: type: string name: type: string filters: type: array items: type: object properties: id: type: string name: type: string hits: type: integer position: type: integer pagination: type: object properties: page: type: integer page_size: type: integer total_pages: type: integer has_more: type: boolean total_results: type: integer total_products: type: integer total_offers: type: integer products_with_test_reports: type: integer category: type: object properties: id: type: string title: type: string sort_options: type: array items: type: string item_states: type: object properties: BARGAIN: type: integer FAST_DELIVERABLE: type: integer EXCLUDE_USED: type: integer SHORT_TERM_BARGAIN: type: integer price_range: type: object properties: min: type: integer max: type: integer buckets: type: array items: type: object properties: to: type: integer hits: type: integer from: type: integer related_queries: type: array items: type: string promoted_filters: type: array items: type: object properties: id: type: string name: type: string meta: type: object properties: duration_ms: type: integer upstream_calls: type: integer description: >- The fields of a recorded response. Other responses can carry more, or leave some out. example: endpoint: idealo.search params: query: air fryer response: success: true query: air fryer category_id: '3513' sort: RELEVANCE_DESC results: - id: '203597427' type: PRODUCT title: Ninja AF500 subheading: Heißluftfritteuse characteristics: - Heißluftfritteuse - 2.470 Watt - 10,4 Liter category_id: '3513' url: >- https://www.idealo.de/preisvergleich/OffersOfProduct/203597427_-af500-ninja.html image_url: >- https://cdn.idealo.com/folder/Product/203597/4/203597427/s1_produktbild_mittelgross/ninja-af500.jpg price: 162.9 price_formatted: 162,90 € currency: EUR offer_count: 80 used_only: false rating: user_review_count: 453 score_percent: 100 test_rating: 2,0 cheapest_offer: offer_key: 7abc0f760d8206c9f1c6127689df9ed0 shop_id: '301558' shop_name: alza.de shop_logo_url: >- https://cdn.idealo.com/folder/Shop/301/5/301558/s1_shop_80x30.png is_merchant: false shipping_costs: 4,99 € shipping_is_free: false voucher: {} is_bestseller: false bestseller_info: rank: 5 has_pros_and_cons: true is_sponsored: false - id: '204292458' type: PRODUCT title: Philips NA221/00 subheading: Heißluftfritteuse characteristics: - Heißluftfritteuse - 1.500 Watt - 4,2 Liter category_id: '3513' url: >- https://www.idealo.de/preisvergleich/OffersOfProduct/204292458_-na221-00-philips.html image_url: >- https://cdn.idealo.com/folder/Product/204292/4/204292458/s1_produktbild_mittelgross/philips-na221-00.jpg price: 76.3 price_formatted: 76,30 € currency: EUR offer_count: 13 used_only: false rating: user_review_count: 1 score_percent: 100 cheapest_offer: offer_key: 393be917a1989c14caaf80db46f0cf6b shop_id: '302342' shop_name: proshop.de shop_logo_url: >- https://cdn.idealo.com/folder/Shop/302/3/302342/s1_shop_80x30.png is_merchant: false shipping_costs: 4,99 € shipping_is_free: false voucher: {} is_bestseller: false has_pros_and_cons: true is_sponsored: false - id: '204910117' type: PRODUCT title: Ninja SL400EU Doppel-Heißluftfritteuse XL subheading: Heißluftfritteuse characteristics: - Heißluftfritteuse - 2.470 Watt - 9,5 Liter category_id: '3513' url: >- https://www.idealo.de/preisvergleich/OffersOfProduct/204910117_-sl400eu-doppel-heissluftfritteuse-xl-ninja.html image_url: >- https://cdn.idealo.com/folder/Product/204910/1/204910117/s1_produktbild_mittelgross/ninja-sl400eu-doppel-heissluftfritteuse-xl.jpg price: 159 price_formatted: 159,00 € currency: EUR offer_count: 42 used_only: false rating: user_review_count: 367 score_percent: 90 test_rating: 2,2 cheapest_offer: offer_key: c10cb8afb4d9ee7c39445acb543dcd40 shop_id: '322253' shop_name: coolblue.de shop_logo_url: >- https://cdn.idealo.com/folder/Shop/322/2/322253/s1_shop_80x30.png is_merchant: false shipping_costs: 0,00 € shipping_is_free: false voucher: {} is_bestseller: false has_pros_and_cons: true is_sponsored: false facets: - id: manufacturer name: Hersteller filters: - id: '106416096' name: aeco hits: 7 position: 8 - id: '101478985' name: AEG hits: 9 position: 9 - id: '1247659' name: Aigostar hits: 63 position: 10 - id: productType name: Produkttyp filters: - id: '995501' name: Doppelfritteuse hits: 533 position: 0 - id: '869281' name: Einbaufritteuse hits: 1 position: 1 - id: '869282' name: Elektro-Fritteuse hits: 75 position: 2 - id: '29932' name: Fettfüllmenge filters: - id: '2927332' name: bis 1,8 Liter hits: 1 position: 0 - id: '2927331' name: 2 bis 2,5 Liter hits: 5 position: 1 - id: '236329' name: 3,2 bis 4 Liter hits: 4 position: 3 pagination: page: 1 page_size: 36 total_pages: 112 has_more: true total_results: 4805 total_products: 2677 total_offers: 2128 products_with_test_reports: 191 category: id: '3513' title: Fritteusen sort_options: - RELEVANCE_DESC - PRICE_ASC - DISCOUNT_DESC item_states: BARGAIN: 124 FAST_DELIVERABLE: 3726 EXCLUDE_USED: 0 SHORT_TERM_BARGAIN: 83 price_range: min: 0 max: 8116 buckets: - to: 60 hits: 1336 - from: 60 to: 90 hits: 1248 - from: 90 to: 140 hits: 1302 related_queries: - Fritteuse - philips airfryer 3000 - philips steam airfryer 5000 series dual basket promoted_filters: - id: '2098877' name: Heißluftfritteuse - id: '101123541' name: Ninja - id: '7005777' name: COSORI meta: duration_ms: 2485 upstream_calls: 2 '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.