# Hepsiburada Categories API Documentation

<p><strong>Hepsiburada Categories API</strong> returns the facet groups of a search query, with brand ids and category links. Use the values from this route in the brand and category filters of the search route.</p><p>One upstream lookup serves the whole route. Costs 1 credit per successful request. Failed requests are free.</p>

- **Documentation:** [https://scrappa.co/docs/hepsiburada-api/hepsiburada_categories](https://scrappa.co/docs/hepsiburada-api/hepsiburada_categories)
- **API group:** Hepsiburada API
- **Endpoint:** `GET https://scrappa.co/api/hepsiburada/categories`

## 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, 1 to 120 characters, for example laptop. |
| `brand` | string | No | Brand name to narrow the facet list. |

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Error | The query failed validation. |
|  | Error | The upstream source could not be reached. |

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