# Conrad Product Search API Documentation

`GET /api/conrad/search` returns Conrad Deutschland products as structured JSON. A page holds up to 24 products.

## What you get

Each item has `id`, `title`, `brand`, `manufacturerId` (the manufacturer part number), numeric `price`, `currency`, `tax_schema`, `available`, `availability_state`, `stock_quantity`, `delivery_date`, `image` and a `position`. Search hits carry no rating or review count, so `rating` and `review_count` are `null`. Use the product or reviews endpoint for those numbers. Use `id` unchanged with those endpoints.

## Prices and filters

Prices are numbers in EUR. `b2b=false` and B2C report the GROSS basis (`tax_schema` GROSS); no net and gross price are mixed in one reply. The upstream applies `query`, `brand`, `category` and `sort` (`relevance`, `price_asc`, `price_desc`). `min_price`, `max_price` and `price` bound the returned page. A filter never returns a product outside its bound. A sort without a verified grammar returns 422 before any lookup.

## Pages

`category` is a public category id from the category routes, such as `c2864444`. `page` is 1-50 and is sent upstream as `from` and `size`; page one is never relabelled. An empty result is HTTP 200 with `items: []`, no charge and `meta.unavailable_reason.no_results`.

## Credits

A successful request costs **1 credit**. Errors, challenges and `404` answers cost nothing. The response shows the charge in `meta.credits_charged`.

- **Documentation:** [https://scrappa.co/docs/conrad-api/conrad_search](https://scrappa.co/docs/conrad-api/conrad_search)
- **API group:** Conrad API
- **Endpoint:** `GET https://scrappa.co/api/conrad/search`

## 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 |
| --- | --- | --- | --- |
| `query` | string | No | Search words. Use this or category. |
| `category` | string | No | Public category id such as c2864444. Use this or query. |
| `sort` | string | No | relevance, price_asc or price_desc. |
| `price` | number | No | Highest price in euros. Alias for max_price. |
| `min_price` | number | No | Lowest price in euros. |
| `max_price` | number | No | Highest price in euros. Must not be lower than min_price. |
| `brand` | string | No | Exact brand as the storefront shows it. |
| `page` | integer | No | Result page of 24 products, 1-50. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/conrad/search?query=arduino"
```

## Example response

```json
{
    "success": true,
    "site": "de",
    "query": "arduino",
    "category": null,
    "items": [
        {
            "position": 1,
            "id": "191789",
            "title": "Example Arduino Board",
            "brand": "Arduino",
            "manufacturerId": "A000073",
            "price": 17.64,
            "currency": "EUR",
            "tax_schema": "GROSS",
            "is_special_offer": false,
            "available": true,
            "availability_state": "IN_STOCK",
            "stock_quantity": 12,
            "delivery_date": "2026-11-23T00:00:00Z",
            "rating": null,
            "review_count": null,
            "image": "https://asset.conrad.com/800/image.jpg"
        }
    ],
    "page": 1,
    "page_size": 24,
    "next_page": 2,
    "has_more": true,
    "sort": "relevance",
    "applied_filters": {
        "query": "arduino"
    },
    "meta": {
        "endpoint_family": "conrad-search",
        "billable": true,
        "attempts": 2,
        "credits_charged": 1,
        "unavailable_reason": []
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing, unknown or unusable. Unknown parameters are rejected, never ignored. Non-billable. |
| 503 | Upstream Unavailable | The upstream could not be reached, answered with a challenge, or changed its JSON shape (`upstream_blocked`, `upstream_unavailable`, `parser_drift`). Retryable and never billed. Clients are never rate limited. |

## 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)
