Hepsiburada

Product Search

Hepsiburada search results for a term, in storefront order: every card's page position, price, campaign price, seller, badges and rating — plus the facets the listing offers and whether the term was typo-corrected.

GET/v1/hepsiburada/search1 credit

Getting every page

This endpoint pages. To collect all of it in one job, queue a batch task instead of walking the pages yourself — it charges the same 1 credit per page and you poll for the result.

curl --request POST 'https://data-api.roketfy.com/v1/tasks' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "platform": "hepsiburada",
  "endpoint": "search",
  "params": {
    "q": "<q>"
  }
}'

See batch tasks for the full lifecycle.

Parameters

Name	Type	Required	Description
q	string	required	The search term, e.g. "iphone 15". Required.
sort	string	optional	How the listing is ordered, using the storefront's own keys: recommended (its default), artanfiyat / azalanfiyat (price up / down), coksatan (best selling), yorumsayisi (most reviewed), degerlendirmepuani (highest rated), indirimurunler (discount rate), enyeni (newest). One of: recommended, artanfiyat, azalanfiyat, coksatan, yorumsayisi, degerlendirmepuani, indirimurunler, enyeni.
page	number	optional	One-based page number — this listing starts at 1, not 0.
pageSize	number	optional	Products per page, 1-36. 36 is what the storefront requests, and its ceiling.
brands	string	optional	Narrow to brands by their storefront slug, comma-separated: "mango" or "mango,ipekyol2". The slugs are the `value` of the `markalar` facet on a response.
filters	string	optional	Any other facet, as `key:value` pairs joined by ";" — "renk:Beyaz;fiyat:100-1900". Keys and values come from the `filters` block of a response; a listing's facets differ per category.

Request

curl --request GET 'https://data-api.roketfy.com/v1/hepsiburada/search?q=%3Cq%3E' \
  --header 'Authorization: Bearer YOUR_TOKEN'

MCP

Available to AI agents as the tool hepsiburada_search, with the same parameters and the same credit cost.