DocumentationDashboard

Hepsiburada

Product Reviews

Customer reviews for a Hepsiburada product, page by page: the review and its photos, per-aspect stars, the seller it was bought from, plus the star/seller/keyword facets and Hepsiburada's own AI summary. Costs 1 credit per page — or 2 for a …-pm-<productId> URL, which has to be resolved to a SKU through the product page first.

GET/v1/hepsiburada/reviews1 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": "reviews",
  "params": {
    "url": "<url>",
    "sku": "<sku>",
    "skus": "<skus>",
    "includeSiblingVariants": "<includeSiblingVariants>",
    "includeSummary": "<includeSummary>"
  }
}'

See batch tasks for the full lifecycle.

Parameters

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

NameTypeRequiredDescription
urlstringone ofFull Hepsiburada product URL, either the …-p-<sku> or …-pm-<productId> form.
skustringone ofOne Hepsiburada SKU, e.g. "HBCV00004X9ZCK".
skusstringone ofSeveral SKUs, comma-separated — reviews for all of them in one list. Overrides sku.
pagenumberoptionalZero-based page number.
pageSizenumberoptionalReviews per page, 1-100. The gateway itself pages by row offset; this endpoint does the arithmetic.
includeSiblingVariantsbooleanrequiredInclude reviews left on the product's other variants (its other colours and sizes). On by default, as the storefront has it — turn it off for one variant's own reviews.
includeSummarybooleanrequiredAsk for Hepsiburada's generated summary and the filter facets alongside the page. With it off, `summary` and `filters` come back null.
starsstringoptionalStar ratings to keep, comma-separated, e.g. "5,4".
merchantsstringoptionalSeller names to keep, **||-separated** e.g. "Hepsiburada||MediaMarkt" — a comma is not a safe separator for seller names. Take the exact names from a first call's `filters.merchants`.
keywordsstringoptionalKeyword facets to keep, **||-separated** e.g. "çok memnunum||çok beğendim". Take the exact phrases from a first call's `filters.keywords`; they differ per product.
searchstringoptionalFree-text search across the review body and title.
sortFieldstringoptionalcreatedAt = newest first, clap = most applauded, star = by rating. Leave it out for Hepsiburada's own default ordering. One of: createdAt, clap, star.
sortDirectionstringoptionalOnly sent alongside sortField, which is the only thing it applies to. One of: desc, asc.

Request

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

MCP

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