# Douglas Suggest API Documentation

<p><strong>Douglas Suggest API</strong> returns product codes and term suggestions from the public German storefront. Each product row has the exact site code that the product and reviews routes accept unchanged, plus its base product id, name, brand, numeric price, currency and full-size image.</p><p><strong>Cost:</strong> 1 credit per request. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/douglas-api/douglas_suggest](https://scrappa.co/docs/douglas-api/douglas_suggest)
- **API group:** Douglas API
- **Endpoint:** `GET https://scrappa.co/api/douglas/suggest`

## 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 | Yes | Search text, 2 to 100 characters. |
| `max` | integer | No | Number of suggestions, 1 to 20 (default 5). |

## Example response

```json
{
    "data": {
        "query": "parfum",
        "terms": [
            "parfum",
            "eau de parfum"
        ],
        "country": "de",
        "products": [
            {
                "id": "5000005003",
                "name": "Eau de Parfum",
                "brand": "Douglas",
                "image": "https://images.douglas.de/is/image/dgl/5000005003-0",
                "price": {
                    "current": 49.9,
                    "currency": "EUR",
                    "original": null,
                    "discount_percent": null
                },
                "base_product": "5000005000"
            }
        ]
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "suggest"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Error | The query or max value is invalid. Not billed. |
|  | Error | Douglas could not be reached. Not billed. |

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