Trendyol API
The Trendyol API returns product data from Turkey's largest e-commerce marketplace as clean JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary product/detail endpoint returns a product's content id, title, brand, price (current, list, discount, coupon, TY-plus) and campaign, and you can pull product/reviews, similar products, run a search with filters, browse a category, pull a seller's products and info, and get suggestions. It is built for price intelligence, catalog enrichment and Turkish e-commerce analytics that need Trendyol data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/trendyol/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "iphone"
}
}{
"ok": true,
"meta": {
"api": "trendyol",
"endpoint": "search",
"mode": "live",
"latency_ms": 479.4,
"record_count": 24,
"bytes": 117170,
"cache_hit": false,
"version": "0.1",
"total_count": 100000,
"page": 1,
"pagination": {
"page": 1,
"has_more": true
}
},
"data": {
"results": [
{
"content_id": 1074210506,
"product_group_id": 815150018,
"title": "İphone 11 / 12 / 13 / 14 Pro - Pro Max Şarj Cihazı ( 20W Adaptör Ve Type-C to Lightinig Kablo )",
"brand": "Apple",
"url": "https://www.trendyol.com/apple/iphone-[redacted-phone]-pro-pro-max-sarj-cihazi-20w-adaptor-ve-type-c-to-lightinig-kablo-p-[redacted-phone]?boutiqueId=61&merchantId=1163676",
"category": "Şarj Aleti",
"merchant_id": 1163676,
"image": "https://cdn.dsmcdn.com/mnresize/400/-/ty1585/prod/QC/20241016/16/f82dd693-cc3b-3322-b5a2-026a6e17bd81/1_org_zoom.jpg",
"price": "1.345 TL",
"price_value": 1345,
"list_price": null,
"list_price_value": null,
"rating": 4.138461538461539,
"comment_count": 65,
"free_cargo": true,
"fast_delivery": null,
"flash_sale": null
},
{
"content_id": 688908361,
"product_group_id": 532476775,
"title": "Yenilenmiş iPhone 11 128 GB Beyaz Cep Telefonu (12 Ay Garantili) - B Kalite",
"brand": "Apple",
"url": "https://www.trendyol.com/apple/yenilenmis-iphone-11-128-gb-beyaz-cep-telefonu-12-ay-garantili-b-kalite-p-[redacted-phone]?boutiqueId=61&merchantId=848995",
"category": "Yenilenmiş Cep Telefonu",
"merchant_id": 848995,
"image": "https://cdn.dsmcdn.com/mnresize/400/-/ty1674/prod/QC/20250509/16/9fef0678-8c8e-387c-b774-98f3607c3121/1_org_zoom.jpg",
"price": "17.046,80 TL",
"price_value": 17046.8,
"list_price": null,
"list_price_value": null,
"rating": 4.008256880733945,
"comment_count": 1090,
"free_cargo": true,
"fast_delivery": null,
"flash_sale": null
},
{
"content_id": 762254881,
"product_group_id": 580170099,
"title": "iPhone 15 128 GB Mavi",
"brand": "Apple",
"url": "https://www.trendyol.com/apple/iphone-15-128-gb-mavi-p-[redacted-phone]?boutiqueId=689770&merchantId=968",
"category": "IOS Cep Telefonları",
"merchant_id": 968,
"image": "https://cdn.dsmcdn.com/mnresize/400/-/ty1609/prod/QC/20241202/09/d1662cea-116d-3e2c-9a7a-66c6204ea0a3/1_org_zoom.jpg",
"price": "48.999 TL",
"price_value": 48999,
"list_price": null,
"list_price_value": null,
"rating": 4.654226125137212,
"comment_count": 1822,
"free_cargo": false,
"fast_delivery": null,
"flash_sale": null
}
],
"query": "iphone"
}
}What the Trendyol API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| product/detail | full product by `url` OR `content_id`: title/brand/price(current+list+discount%/coupon/ty+)/campaign(+campaigns[])/rating+comment_count/in_stock/seller(+score)/other_offers/category/images/attributes(specs)/variants. The dual-use influencer module. | Pricing teams call product/detail to get full product by `url` OR `content_id`. | url, content_id |
| product/reviews | 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. | Marketplace operators call product/reviews to get paginated reviews by `content_id` OR `url`. | content_id, url, page, page_size |
| product/similar | 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. | Catalog enrichment teams call product/similar to get similar/cross-sell products by `content_id` OR `url` → results[]{content_id,title,brand,url,p…. | content_id, url, page, size |
| search | Search Trendyol products by keyword with optional sort & price/brand filters → results[]{content_id,title,brand,url,price,list_price,rating,comment_count,category,image,free_cargo}. Resolves content_ids for product/detail. Paginated+deduped (page 1-based, max_pages ≤10). meta.total_count = full result-set size. | Retail analysts call search to search Trendyol products by keyword with optional sort & price/brand filters → results[]{cont…. | query, page, max_pages, sort, price, ... |
| search/filters | Discover the available filter facets for a `query` OR `category_id` before filtering — brands (with ids for the `brand` param), price ranges, product ratings, and category-specific attributes (RAM, screen size, color, …) each with live result counts. | Pricing teams call search/filters to discover the available filter facets for a `query` OR `category_id` before filtering. | query, category_id |
| category/products | Browse a Trendyol category by id — best-sellers, newest, or price/brand-filtered product lists. Same card shape as search. Get a category_id from a product's category.id (product/detail) or the '-c<id>' in a category URL. | Marketplace operators call category/products to get browse a Trendyol category by id. | category_id, url, page, max_pages, sort, ... |
| seller/products | All products of a Trendyol seller/store (paginated, sortable, filterable) by seller_id. Same card shape as search. meta.total_count = the seller's full catalog size. | Catalog enrichment teams call seller/products to get all products of a Trendyol seller/store (paginated, sortable, filterable) by seller_id. | seller_id, url, page, max_pages, sort, ... |
| seller/info | Trendyol seller/store profile by seller_id: store name, legal entity (official_name), total product_count, seller score, and trust badges. | Retail analysts call seller/info to get trendyol seller/store profile by seller_id. | seller_id, url |
| suggest | keyword suggestions for a query (ops; search-fallback if suggest API blocked) | Pricing teams call suggest to get keyword suggestions for a query (ops; search-fallback if suggest API blocked). | query |
Call search from your stack
curl -X POST https://api.reefapi.com/trendyol/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone"}'import requests
r = requests.post(
"https://api.reefapi.com/trendyol/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "iphone"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/trendyol/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "iphone"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.trendyol.search with {"query":"iphone"}.Who uses this API and why
- Pricing teams call search and product/detail to track Trendyol prices, discounts and coupons.
- Catalog-enrichment tools use product/detail and reviews to fill listings with specs and ratings.
- Seller-intelligence products use seller/products to audit a competitor's full Trendyol catalog.
Questions developers ask before integrating
What is the Trendyol API?
Trendyol API is a ReefAPI endpoint group for turkish marketplace products, prices and reviews. It returns live JSON through POST requests under /trendyol/v1.
Is the Trendyol API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Trendyol calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Trendyol login or account?
No login to Trendyol is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Trendyol data?
The page example is captured from a live product/detail call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Trendyol API use?
Trendyol actions currently cost 1-2 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Trendyol from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call trendyol actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Trendyol API a Trendyol scraper?
It is the managed alternative to a DIY Trendyol scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same turkish marketplace products, prices and reviews back as clean JSON.
Why does my Trendyol scraper keep getting blocked?
Most Trendyol scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.