# Geizhals API

> The Geizhals API by everydata.io returns live Geizhals data (price comparison: every shop's offer for a product, best price and price history (de, at, eu)) as structured JSON: 3 endpoints under /gzh, one API key, 100 free requests a month.

- URL: https://everydata.io/apis/geizhals
- Updated: 2026-10-05
- Publisher: everydata.io (https://everydata.io)

Compare what shops charge for the same product on Geizhals, the price comparison site of Germany and Austria. Search by keyword and get the best price and number of offers per product, or open one product and get every shop's offer: price, shipping cost, total price, availability and delivery time, shop rating and payment methods, plus the product's EAN, specs and variants. The daily best-price history shows whether today's price is a good deal. Shops appear with their shop name only; no user reviews or reviewer data.

## Key facts

- Status: beta
- Endpoints: 3 (path prefix `/gzh`)
- Quota: A call to the Geizhals API counts as 1 request against the monthly quota.
- Pricing: 100 free requests a month; paid plans from €30 a month for 5,000 requests (€1.00–€6.00 per 1,000 requests). One quota is shared across all 34 platforms; failed requests (5xx, blocked pages) are not counted.
- Measured average response time (last 24 h): 1.8 s, success rate 100% – live figures at https://everydata.io/status
- Authentication: `x-api-key` header

## Endpoints

- `GET /gzh/geizhals-search-by-keyword` – Search products by keyword. Search the Geizhals price comparison by keyword (`domainCode` de, at or eu), optionally inside one category (`categoryId` from `categories[]` of a previous search). Params: `keyword`, `page`?, `sortBy`?, `domainCode`?, `categoryId`?.
- `GET /gzh/geizhals-lookup-product` – Product details with all merchant offers. Product details and the offers of all merchants for a Geizhals product, by URL or by `productId` + `domainCode`: title, manufacturer, best price and price range, EAN, rating, test score, specs, categories, images, varia… Params: `url`?, `productId`?, `domainCode`?.
- `GET /gzh/geizhals-price-history` – Best price history. Daily best price of a Geizhals article over a period (`1w`, `1m`, `3m`, `6m`, `1y`, `max`) on one Geizhals site, from the site's own price chart: lowest/highest/average price with dates and the day-by-day series (`price… Params: `url`?, `productId`?, `period`?, `domainCode`?.

## Example

```bash
curl -s "https://api.everydata.io/gzh/geizhals-lookup-product?url=https%3A%2F%2Fgeizhals.de%2Fapple-iphone-15-128gb-schwarz-a3020645.html" \
  -H "x-api-key: YOUR_API_KEY"
```

```json
{
  "responseStatus": "PRODUCT_FOUND_RESPONSE",
  "responseMessage": "Product successfully found!",
  "productTitle": "Apple iPhone 15 128GB schwarz",
  "manufacturer": "Apple",
  "productId": "3020645",
  "bestPrice": 659,
  "priceRange": {
    "min": 659,
    "max": 949
  },
  "offerCount": 42,
  "currency": "EUR",
  "ean": "0195949036064",
  "offers": [
    {
      "position": 1,
      "merchant": "Top_Handy",
      "price": 659,
      "shippingCost": 0,
      "totalPrice": 659,
      "availability": "shortly",
      "deliveryTime": "1-2 Werktage",
      "merchantRating": "1.3",
      "merchantRatingCount": 6,
      "country": "DE"
    }
  ]
}
```

## Use cases

- Competitor price monitoring
- Best-price and deal alerts
- MAP / RRP compliance across shops
- AI assistants answering “where is it cheapest?”

## FAQ

### What data does the Geizhals API return?

Price comparison: every shop's offer for a product, best price and price history (DE, AT, EU). The API has 3 endpoints under the /gzh path – search products, product offers and price history – and every response is structured JSON that starts with responseStatus and responseMessage.

### What does “beta” mean for the Geizhals API?

The endpoints and response fields are usable today, but they can still change and the platform is not yet counted in the headline success rate. Blocked or failed calls are not billed.

### How much does the Geizhals API cost?

A call to the Geizhals API counts as 1 request against the monthly quota. The Geizhals API is included in every plan and shares one quota with all other platforms: 100 free requests a month; paid plans from €30 a month for 5,000 requests (€1.00–€6.00 per 1,000 requests). Failed requests (5xx, blocked pages) are not counted.

### Is the Geizhals data realtime?

Yes. Each request loads the live Geizhals page when you call the API – there is no database of old snapshots in between.

### Do I need a Geizhals account or an official Geizhals API key?

No. You only need an everydata.io API key, sent in the x-api-key header. The free plan works without a credit card.

### Is this a Geizhals scraper?

It replaces one. everydata.io loads the live Geizhals pages for you and returns parsed JSON fields, so you do not build or maintain a Geizhals scraper, parser or proxy setup yourself. Retries are included, and a request that still fails costs no quota.

### What happens when Geizhals blocks a request?

The API retries the fetch automatically. If the page still cannot be loaded you get a 502 or 503 error, and that request costs no quota. Success rates and response times per platform are measured around the clock on the status page.

### Can ChatGPT, Claude or an AI agent use the Geizhals API?

Yes. Connect the hosted everydata.io MCP server and the assistant can call every Geizhals endpoint as a tool, or register the plain HTTPS endpoints as functions in any agent framework. The endpoint list is also in /llms.txt and the OpenAPI spec.

## More

- [All platforms](https://everydata.io/apis) · [Pricing](https://everydata.io/pricing) · [API reference](https://everydata.io/docs) · [Getting started](https://everydata.io/docs/getting-started) · [MCP server](https://everydata.io/docs/mcp) · [Status](https://everydata.io/status)
- Machine-readable: [llms.txt](https://everydata.io/llms.txt), [llms-full.txt](https://everydata.io/llms-full.txt), [OpenAPI](https://api.everydata.io/openapi.json)
