DocumentationDashboard

Hepsiburada

Category Products

Everything listed in a Hepsiburada category, in storefront order — the same cards a search returns, for a category page instead of a search term.

GET/v1/hepsiburada/category-products1 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": "category-products",
  "params": {
    "categoryId": "<categoryId>",
    "url": "<url>"
  }
}'

See batch tasks for the full lifecycle.

Parameters

Supply at least one of categoryId or url. Neither is required on its own.

NameTypeRequiredDescription
categoryIdstringone ofThe category's numeric id, e.g. "12087202". Either this or url.
urlstringone ofThe category's storefront URL — the id is the `-c-<id>` at the end of it: https://www.hepsiburada.com/elbiseler-c-12087202. Either this or categoryId.
sortstringoptionalHow 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.
pagenumberoptionalOne-based page number — this listing starts at 1, not 0.
pageSizenumberoptionalProducts per page, 1-36. 36 is what the storefront requests, and its ceiling.
brandsstringoptionalNarrow to brands by their storefront slug, comma-separated: "mango" or "mango,ipekyol2". The slugs are the `value` of the `markalar` facet on a response.
filtersstringoptionalAny 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/category-products?categoryId=%3CcategoryId%3E' \
  --header 'Authorization: Bearer YOUR_TOKEN'

MCP

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