---
title: "GET /geizhals/search"
method: GET
path: "/geizhals/search"
tags: ["Geizhals"]
---

# GET /geizhals/search

`GET /geizhals/search`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/geizhals/search`
- Auth: API key in header `X-API-KEY`

## Query parameters

- `query` string, required
- `loc` 'de' | 'at' | 'eu' | 'pl' | 'uk' | 'null', nullable
- `lang` 'de' | 'en' | 'null', nullable
- `page` integer, nullable
- `pagesize` integer, nullable
- `sort` string, nullable
- `category` string, nullable
- `manufacturer` string, nullable

## Response `200`

- union
  - object
    - `success` boolean, required
    - `query` string, required
    - `loc` string, required
    - `lang` string, required
    - `page` unknown, required
    - `pagesize` integer, required
    - `total` integer, required
    - `products` unknown[], required
      - unknown
    - `pager` object, required
      - `first_page` 1, required
      - `next_page` number, nullable, required
      - `last_page` unknown, required
    - `facets` string, nullable, required
    - `category_suggestions` unknown[], required
      - unknown
    - `meta` object, required
      - `duration_ms` integer, required
      - `attempts` string, required
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'UPSTREAM_UNAVAILABLE', required
      - `message` 'Geizhals product API is temporarily unavailable. Please retry.' | 'Geizhals product API is currently unavailable.', required
      - `failure_type` 'unexpected_response_shape', required
      - `http_status` integer, required
    - `meta` object, required
      - `duration_ms` integer, required
      - `attempts` integer, required
      - `billable` boolean, required
      - `retryable` boolean, required
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'UPSTREAM_REJECTED', required
      - `message` 'Geizhals could not process this request.', required
      - `failure_type` 'upstream_rejected', required
      - `http_status` 422, required
    - `meta` object, required
      - `duration_ms` integer, required
      - `attempts` integer, required
      - `billable` boolean, required
      - `retryable` boolean, required
  - object
    - `success` boolean, required
    - `data` string, required
    - `attempts` integer, required
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'UPSTREAM_UNAVAILABLE', required
      - `message` 'Geizhals product API is temporarily unavailable. Please retry.', required
      - `failure_type` 'proxy_pool_empty', required
      - `http_status` 503, required
    - `meta` object, required
      - `duration_ms` integer, required
      - `attempts` integer, required
      - `billable` boolean, required
      - `retryable` boolean, required
  - object
    - `success` boolean, required
    - `error` object, required
      - `code` 'UPSTREAM_UNAVAILABLE', required
      - `message` 'Geizhals product API is temporarily unavailable. Please retry.', required
      - `failure_type` 'not_configured', required
      - `http_status` 503, required
    - `meta` object, required
      - `duration_ms` integer, required
      - `attempts` integer, required
      - `billable` boolean, required
      - `retryable` boolean, required
  - string

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `422`: One or more query parameters failed validation.
- `503`: The upstream service is temporarily unavailable. Please retry shortly.

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/1e1aa78ff103?raw)