docs / trendyol

Trendyol

Turkish marketplace products, prices and reviews.

base /trendyol/v15 endpoints

post/trendyol/v1/product/detail1 credit

full product by `url` OR `content_id`: title/brand/price(current+list+discount%/coupon/ty+)/rating+comment_count/in_stock/seller(+score)/other_offers/category/images/attributes(specs)/variants. The dual-use influencer module.

Parameter		Allowed / range	Description
content_id	optional	—	Trendyol product ID — the digits after '-p-' in the product URL (…-p-<id>). Take it from search results. Provide content_id OR url.
url	optional	—	Full Trendyol product URL — alternative to content_id.

Try in playground →

post/trendyol/v1/product/reviews2 credits

paginated reviews by `content_id` OR `url`: {ai_summary (AI review digest), summary(avg/total_rating_count/total_comment_count/total_pages), reviews[]{user,rating,comment,date,seller,trusted,is_influencer,images}}. page/page_size params.

Parameter		Allowed / range	Description
content_id	optional	—	Trendyol product ID — the digits after '-p-' in the product URL (…-p-<id>). Take it from search results. Provide content_id OR url.
url	optional	—	Full Trendyol product URL — alternative to content_id.
page = 0	optional	0–	Review page — 0-BASED (first page = 0, then 1, 2…); summary.total_pages tells you how many exist.
page_size = 30	optional	1–50	Reviews per page (1–50; larger values are capped at 50).

Try in playground →

post/trendyol/v1/product/similar1 credit

similar/cross-sell products by `content_id` OR `url` → results[]{content_id,title,brand,url,price,list_price,rating,comment_count,image,category}. page/size params.

Parameter		Allowed / range	Description
content_id	optional	—	Trendyol product ID — the digits after '-p-' in the product URL (…-p-<id>). Take it from search results. Provide content_id OR url.
url	optional	—	Full Trendyol product URL — alternative to content_id.
page = 0	optional	0–	Result page — 0-BASED (first page = 0).
size = 20	optional	1–40	How many similar products (1–40; larger values are capped at 40).

Try in playground →

post/trendyol/v1/search2 credits

product search → results[]{content_id,title,brand,url,price,list_price,rating,comment_count,category,image}. Resolves content_ids for product/detail. page (1-based) + max_pages (≤10, paginated+deduped via &pi=).

Parameter		Allowed / range	Description
query	required	—	What to search for (Turkish keywords work best).
page = 1	optional	1–	Result page to start from — 1-BASED (1, 2, 3…).
max_pages = 1	optional	1–10	How many consecutive pages to fetch + dedup in one call (1–10, ~24 results/page; larger values are capped at 10).

Try in playground →

post/trendyol/v1/suggest1 credit

keyword suggestions for a query (ops; search-fallback if suggest API blocked)

Parameter		Allowed / range	Description
query	required	—	Partial search text to complete.

Try in playground →

Example request · product/detail

curl -X POST https://api.reefapi.com/trendyol/v1/product/detail \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"content_id":762254881}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}