> ## Documentation Index > Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt > Use this file to discover all available pages before exploring further. # Scrape idealo search > Searches idealo (price comparison; `country` de, at, uk, fr, it or es) for `query` and returns `products`, each with `position`, `type` (product = a price comparison of many shops, offer = a single shop offer idealo has not matched to a product), `productId`, `offerId`, `title`, `subtitle`, `characteristics`, `url` (the product's price comparison, or the shop link of a single offer), `image`, `lowestPrice`, `basePrice` (unit price text, when idealo shows one), `offerCount`, `usedOnly`, `cheapestShop` (id, name, shipping cost, delivery, free-return days), `rating` (stars, rounded to half a star by idealo), `reviewCount`, `testGrade` (the average press test grade, where 1 is best), `energyClass`, `bargainSavingPercent`, `bestsellerRank`, `categoryId` and `variantOf`. Also `total`, `productCount`, `lastPage` and `nextPage`, and `currency`. `sort` orders the results (relevance or price_asc); `page` and `max_results` page through them. Use `/marketplace/idealo-offers` for all shop offers of one product. One unit per idealo page read. ## OpenAPI ````yaml /api-reference/openapi.json post /marketplace/idealo-search openapi: 3.1.0 info: title: ScrapeUnblocker API description: >- Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate every request with the `x-scrapeunblocker-key` header. Documented here: page-source extraction, Google SERP scraping, image fetch, and the dedicated plugin endpoints (search engines, marketplaces, reviews, travel, social and more). All other paths exist for internal operations and are intentionally hidden from this spec. version: 3.0.0 servers: - url: https://api.scrapeunblocker.com description: Production security: [] paths: /marketplace/idealo-search: post: tags: - Plugins summary: Scrape idealo search description: >- Searches idealo (price comparison; `country` de, at, uk, fr, it or es) for `query` and returns `products`, each with `position`, `type` (product = a price comparison of many shops, offer = a single shop offer idealo has not matched to a product), `productId`, `offerId`, `title`, `subtitle`, `characteristics`, `url` (the product's price comparison, or the shop link of a single offer), `image`, `lowestPrice`, `basePrice` (unit price text, when idealo shows one), `offerCount`, `usedOnly`, `cheapestShop` (id, name, shipping cost, delivery, free-return days), `rating` (stars, rounded to half a star by idealo), `reviewCount`, `testGrade` (the average press test grade, where 1 is best), `energyClass`, `bargainSavingPercent`, `bestsellerRank`, `categoryId` and `variantOf`. Also `total`, `productCount`, `lastPage` and `nextPage`, and `currency`. `sort` orders the results (relevance or price_asc); `page` and `max_results` page through them. Use `/marketplace/idealo-offers` for all shop offers of one product. One unit per idealo page read. operationId: idealo_search_marketplace_idealo_search_post parameters: - name: query in: query required: true schema: type: string description: What to search for, e.g. 'iphone 17' or 'kaffeevollautomat'. title: Query description: What to search for, e.g. 'iphone 17' or 'kaffeevollautomat'. - name: country in: query required: false schema: type: string description: >- idealo site: de, at, uk, fr, it, es (default de; uk = idealo.co.uk). default: de title: Country description: 'idealo site: de, at, uk, fr, it, es (default de; uk = idealo.co.uk).' - name: sort in: query required: false schema: type: string description: 'Result order: relevance, price_asc (price_asc = cheapest first).' default: relevance title: Sort description: 'Result order: relevance, price_asc (price_asc = cheapest first).' - name: page in: query required: false schema: type: integer description: First idealo results page to read (1-100). default: 1 title: Page description: First idealo results page to read (1-100). - name: max_results in: query required: false schema: type: integer description: >- Products to collect across pages, 1-300. A page holds 60 products; each page is one unit. default: 60 title: Max Results description: >- Products to collect across pages, 1-300. A page holds 60 products; each page is one unit. responses: '200': description: JSON with a `products` array. content: application/json: schema: {} '400': description: Invalid parameters. '404': description: idealo found nothing for this search. '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '502': description: >- Blocked by idealo on every attempt, an unusable answer, or no answer in time. security: - ScrapeUnblockerKey: [] components: schemas: HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: ScrapeUnblockerKey: type: apiKey in: header name: x-scrapeunblocker-key description: Your ScrapeUnblocker API key. Apply on every request. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.