Skip to content
Scrappa Get API key
Hepsiburada API 1 credit / request

Hepsiburada Search API Documentation

GET https://scrappa.co/api/hepsiburada/search

Hepsiburada Search API 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.

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: min_price and max_price answer 422. The same applies to sort.

Costs 1 credit per successful request with data. A valid empty answer is a free 200; failed requests are free.

Hepsiburada Search API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/hepsiburada/search
Auth header
x-api-key
Cost
1 credit / request
query = coffee shops
Response preview
200 OK
Example JSON appears below when a response schema is available for this endpoint.

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

3 optional filters available.

query string Required

Search text, 1 to 120 characters, for example laptop.

Example value coffee shops
page integer Optional

One-based page number, 1 to 49 (default 1). 36 results per page.

Example value 1
brand string Optional

Brand slug from the Categories API, for example asus or hp-compaq.

Example value example
category string Optional

Facet value in key:value form from the Categories API, for example ramsistembellegi:16 GB.

Example value example

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

HTTP 422

A parameter failed validation, for example sort or a price filter.

404

HTTP 404

The requested product does not exist.

503

HTTP 503

The upstream source could not be reached.

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.