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.
Run this endpoint
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.
string
Required
Search text, 1 to 120 characters, for example laptop.
coffee shops
integer
Optional
One-based page number, 1 to 49 (default 1). 36 results per page.
1
string
Optional
Brand slug from the Categories API, for example asus or hp-compaq.
example
string
Optional
Facet value in key:value form from the Categories API, for example ramsistembellegi:16 GB.
example
Errors
Handle these documented responses before retrying or showing customer-facing failures.
HTTP 422
A parameter failed validation, for example sort or a price filter.
HTTP 404
The requested product does not exist.
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.