# Hepsiburada Search API Documentation

<p><strong>Hepsiburada Search API</strong> searches the Hepsiburada marketplace (Turkey). Each item has a numeric price in TRY, the original price, the discount percent, brand, seller, category, rating and full size image URLs.</p><p>Filter by brand slug or a facet key:value pair from the Categories API. The site applies the filter; Scrappa does not drop cards after the fetch. Page N returns the real page N, 36 items per page, up to page 49. A price filter is not offered yet: <code>min_price</code> and <code>max_price</code> answer 422. The same applies to <code>sort</code>.</p><p>Costs 1 credit per successful request with data. A valid empty answer is a free 200; failed requests are free.</p>

- **Documentation:** [https://scrappa.co/docs/hepsiburada-api/hepsiburada_search](https://scrappa.co/docs/hepsiburada-api/hepsiburada_search)
- **API group:** Hepsiburada API
- **Endpoint:** `GET https://scrappa.co/api/hepsiburada/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 | Yes | Search text, 1 to 120 characters, for example laptop. |
| `page` | integer | No | One-based page number, 1 to 49 (default 1). 36 results per page. |
| `brand` | string | No | Brand slug from the Categories API, for example asus or hp-compaq. |
| `category` | string | No | Facet value in key:value form from the Categories API, for example ramsistembellegi:16 GB. |

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Error | A parameter failed validation, for example sort or a price filter. |
|  | Error | The requested product does not exist. |
|  | 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)
