> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anysite.io/llms.txt
> Use this file to discover all available pages before exploring further.

# /idealo/products/search

> Search Idealo for products on a chosen national Idealo site and get back product cards with the Idealo product id, name, the specification summary shown in the listing, product page URL and image, the lowest offer price with its currency, the price per reference unit where the product is sold by weight or volume, how many shops offer it, the average user star rating with its review count, the aggregated expert test grade where Idealo has one, and any listing badge such as bestseller.

**Price:** 20 credits per 36 results

**⚠️ Common errors:** 412: The query matched no products on this national Idealo site



## OpenAPI

````yaml /openapi/price-comparison.json post /api/idealo/products/search
openapi: 3.1.0
info:
  title: Any Site API
  description: >+
    Any Site API provides programmatic access to data from LinkedIn, Instagram,
    Twitter, and other platforms.


    ## Authentication


    All API endpoints require an `access-token` header with a valid API token.
    Tokens can be created in the [dashboard](https://app.anysite.io/).


    ## Pricing


    Each endpoint has a credit cost listed in its description. Credits are
    deducted from your token balance per request.

  version: 0.0.1
servers: []
security:
  - AccessToken: []
paths:
  /api/idealo/products/search:
    post:
      tags:
        - /idealo
      summary: /idealo/products/search
      description: >-
        Search Idealo for products on a chosen national Idealo site and get back
        product cards with the Idealo product id, name, the specification
        summary shown in the listing, product page URL and image, the lowest
        offer price with its currency, the price per reference unit where the
        product is sold by weight or volume, how many shops offer it, the
        average user star rating with its review count, the aggregated expert
        test grade where Idealo has one, and any listing badge such as
        bestseller.


        **Price:** 20 credits per 36 results


        **⚠️ Common errors:** 412: The query matched no products on this
        national Idealo site
      operationId: __api_idealo_products_search_post
      parameters:
        - name: access-token
          in: header
          required: true
          schema:
            anyOf:
              - type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IdealoProductsSearchPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/IdealoSearchProduct'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    IdealoProductsSearchPayload:
      properties:
        timeout:
          type: integer
          maximum: 1500
          minimum: 20
          default: 300
        query:
          type: string
          minLength: 1
        country:
          $ref: '#/components/schemas/IdealoCountry'
          default: de
        count:
          type: integer
          maximum: 720
          minimum: 1
      type: object
      required:
        - query
        - count
    IdealoSearchProduct:
      properties:
        '@type':
          type: string
          default: IdealoSearchProduct
        id:
          type: string
        country:
          type: string
        currency:
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
        url:
          anyOf:
            - type: string
            - type: 'null'
        image:
          anyOf:
            - type: string
            - type: 'null'
        price:
          anyOf:
            - type: number
            - type: 'null'
        base_price:
          anyOf:
            - type: number
            - type: 'null'
        base_price_unit:
          anyOf:
            - type: string
            - type: 'null'
        offer_count:
          anyOf:
            - type: integer
            - type: 'null'
        rating:
          anyOf:
            - type: number
            - type: 'null'
        review_count:
          anyOf:
            - type: integer
            - type: 'null'
        test_score:
          anyOf:
            - type: number
            - type: 'null'
        badges:
          items:
            type: string
          type: array
          default: []
      type: object
      required:
        - id
        - country
        - currency
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
      type: object
    IdealoCountry:
      type: string
      enum:
        - de
        - at
        - gb
        - fr
        - it
        - es
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
        msg:
          type: string
        type:
          type: string
        input: {}
        ctx:
          type: object
      type: object
      required:
        - loc
        - msg
        - type
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: access-token
      description: API token from the dashboard

````