# idealo Shop API Documentation

Fetch a shop profile by shop ID from an offer: name, logo, address, rating and rating count, payment methods, shipping providers and notes, the latest customer reviews and idealo's own shop rating with postal services. idealo_rating and postal_services are empty for some marketplace sellers.

- **Documentation:** [https://scrappa.co/docs/idealo-api/idealo_shop](https://scrappa.co/docs/idealo-api/idealo_shop)
- **API group:** idealo API
- **Endpoint:** `GET https://scrappa.co/api/idealo/shop`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `shop_id` | string | Yes | idealo shop ID from an offer, for example 338630. |

## Example response

```json
{
    "meta": {
        "duration_ms": 1500,
        "upstream_calls": 2
    },
    "name": "smartport.de (Marktplatzh\u00e4ndler)",
    "rating": {
        "best": 5,
        "count": 1762,
        "value": 4.38
    },
    "address": {
        "street": "Gotthardstrasse 14",
        "locality": "Zug, CH",
        "postal_code": "6300"
    },
    "reviews": [],
    "shop_id": "338630",
    "success": true,
    "idealo_rating": {
        "type": "IDEALO",
        "count": 1762,
        "score": 4.38,
        "percent": 90
    },
    "payment_methods": [
        "Visa",
        "PayPal",
        "Rechnung"
    ],
    "postal_services": [
        {
            "name": "GLS",
            "type": "regular"
        }
    ],
    "shipping_providers": [
        "GLS",
        "DHL"
    ]
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | Returned when a required parameter is missing or a value is out of range. No credits are charged. |
| 404 | Not Found | Returned when idealo does not know the product, shop or page. No credits are charged. |
| 503 | Service Unavailable | Returned when idealo could not be read after several attempts. Failed requests are not charged. Try again. |
| 502 | Unexpected Response | Returned when idealo answers with a page this API cannot read. Failed requests are not charged. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)