APIs / Marketplaces / Trendyol
1 credit per call4 endpoints16 datapoints
Trendyol API
Trendyol API for product search with price, rating and gender filters, search filters, product details and reviews as JSON. 1 credit per successful call.
{
"success": true,
"data": {
"query": "elbise",
"page": 1,
"per_page": 36,
"items": [
{
"position": 1,
"id": "1090399394",
"name": "Siyah Kadın Dik Yaka Toka Detaylı Kuşaklı Toparlayıcı Kalıp Mini Elbise",
"brand": {
"id": 997056,
"name": "World Fashion Trends"
},
"seller_id": 868610,
"category": {
"id": 1182,
"name": "Elbise"
},
"url": "https://www.trendyol.com/world-fashion-trends/siyah-kadin-dik-yaka-toka-detayli-kusakli-toparlayici-kalip-mini-elbise-p-1090399394",
"price": {
"current": 431.1,
"original": 431.1,
"currency": "TRY"
},
"rating": {
"average": 4.361393323657475,
"count": 1378
},
"color": "Siyah",
"size_shown": "XS",
"images": [
"https://cdn.dsmcdn.com/ty2012/prod/QC_ENRICHMENT/20261109/09/86f6fca7-760f-3f9a-9c42-e65aac007386/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty2013/prod/QC_ENRICHMENT/20261109/09/a5afcd0a-9fb6-3f47-baff-d88c70ea5665/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty2011/prod/QC_ENRICHMENT/20261109/09/38c52839-e4d3-3a11-9020-46b2a4b29020/1_org_zoom.jpg"
],
"free_shipping": true,
"sold_out": false,
"is_sponsored": true,
"group_id": 829511467
},
{
"position": 2,
"id": "901692264",
"name": "ELDİVENLİ ELBİSE",
"brand": {
"id": 962101,
"name": "TAYT VEGAS"
},
"seller_id": 460508,
"category": {
"id": 1182,
"name": "Elbise"
},
"url": "https://www.trendyol.com/tayt-vegas/eldivenli-elbise-p-901692264",
"price": {
"current": 1500,
"original": 1500,
"currency": "TRY"
},
"rating": {
"average": 4.603576751117735,
"count": 671
},
"color": "Bordo",
"size_shown": "S",
"images": [
"https://cdn.dsmcdn.com/ty1643/prod/QC/20250223/12/34bd887f-a2e9-3e9b-9bd2-a21f3326f8a9/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty1643/prod/QC/20250223/12/fad649e4-89d9-3d1e-a702-4f8b48867b12/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty1641/prod/QC/20250223/12/7f693592-6bdb-3be2-811f-94665de873d4/1_org_zoom.jpg"
],
"free_shipping": true,
"sold_out": false,
"is_sponsored": true,
"promotions": [
"2 Adet ve Üzeri %5 İndirim"
],
"group_id": 689874545
},
{
"position": 3,
"id": "994938191",
"name": "Tek Omuz Boyunlu Zarif Dökümlü Kahverengi Maxi Elbise",
"brand": {
"id": 2615974,
"name": "Dilay Gökoğlu Butik"
},
"seller_id": 1107503,
"category": {
"id": 1182,
"name": "Elbise"
},
"url": "https://www.trendyol.com/dilay-gokoglu-butik/tek-omuz-boyunlu-zarif-dokumlu-kahverengi-maxi-elbise-p-994938191",
"price": {
"current": 1421.44,
"original": 1421.44,
"currency": "TRY"
},
"rating": {
"average": 4.653566229985444,
"count": 687
},
"color": "Kahverengi",
"size_shown": "XL",
"images": [
"https://cdn.dsmcdn.com/ty1765/prod/QC_PREP/20250930/23/a9b47cf6-0567-3e4c-9bfd-fe33823e915a/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty1818/prod/QC_ENRICHMENT/20260131/14/40dd50d3-158e-3fc6-8659-c6484bc4960b/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty1765/prod/QC_PREP/20250930/23/b904f4c2-f780-37d5-82b7-9a814a0b2857/1_org_zoom.jpg"
],
"free_shipping": true,
"sold_out": false,
"is_sponsored": true,
"promotions": [
"2 Adet ve Üzeri 30 TL İndirim",
"3 Adet ve Üzeri 80 TL İndirim"
],
"group_id": 758825955
}
],
"total_results": 100000,
"total_capped": true,
"has_next_page": true
},
"meta": {
"endpoint_family": "search",
"request_id": "req_29fbfda0f07f4332b34e519e2628ebb1",
"credits_charged": 1,
"credits_remaining": 1929
}
}Sample data
What one call returns
A recorded run of search: the fields and shapes you will get, shortened to 3 items.
| # | positioninteger | idstring | namestring | brandobject | seller_idinteger | categoryobject | urlurl | priceobject | ratingobject | colorstring | size_shownstring | imagesstring[] | free_shippingboolean | sold_outboolean | is_sponsoredboolean | group_idinteger |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | 1 | 1090399394 | Siyah Kadın Dik Yaka Toka Detaylı Kuşaklı Toparlayıcı Kalıp Mini Elbise | {2 fields} | 868610 | {2 fields} | https://www.trendyol.com/world-fashion-trends/siyah-kadin-dik-yaka-toka-detayli-kusakli-toparlayici-kalip-mini-elbise-p-1090399394 | {3 fields} | {2 fields} | Siyah | XS | [3 items] | true | false | true | 829511467 |
| 2 | 2 | 901692264 | ELDİVENLİ ELBİSE | {2 fields} | 460508 | {2 fields} | https://www.trendyol.com/tayt-vegas/eldivenli-elbise-p-901692264 | {3 fields} | {2 fields} | Bordo | S | [3 items] | true | false | true | 689874545 |
| 3 | 3 | 994938191 | Tek Omuz Boyunlu Zarif Dökümlü Kahverengi Maxi Elbise | {2 fields} | 1107503 | {2 fields} | https://www.trendyol.com/dilay-gokoglu-butik/tek-omuz-boyunlu-zarif-dokumlu-kahverengi-maxi-elbise-p-994938191 | {3 fields} | {2 fields} | Kahverengi | XL | [3 items] | true | false | true | 758825955 |
[
{
"position": 1,
"id": "1090399394",
"name": "Siyah Kadın Dik Yaka Toka Detaylı Kuşaklı Toparlayıcı Kalıp Mini Elbise",
"brand": {
"id": 997056,
"name": "World Fashion Trends"
},
"seller_id": 868610,
"category": {
"id": 1182,
"name": "Elbise"
},
"url": "https://www.trendyol.com/world-fashion-trends/siyah-kadin-dik-yaka-toka-detayli-kusakli-toparlayici-kalip-mini-elbise-p-1090399394",
"price": {
"current": 431.1,
"original": 431.1,
"currency": "TRY"
},
"rating": {
"average": 4.361393323657475,
"count": 1378
},
"color": "Siyah",
"size_shown": "XS",
"images": [
"https://cdn.dsmcdn.com/ty2012/prod/QC_ENRICHMENT/20261109/09/86f6fca7-760f-3f9a-9c42-e65aac007386/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty2013/prod/QC_ENRICHMENT/20261109/09/a5afcd0a-9fb6-3f47-baff-d88c70ea5665/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty2011/prod/QC_ENRICHMENT/20261109/09/38c52839-e4d3-3a11-9020-46b2a4b29020/1_org_zoom.jpg"
],
"free_shipping": true,
"sold_out": false,
"is_sponsored": true,
"group_id": 829511467
},
{
"position": 2,
"id": "901692264",
"name": "ELDİVENLİ ELBİSE",
"brand": {
"id": 962101,
"name": "TAYT VEGAS"
},
"seller_id": 460508,
"category": {
"id": 1182,
"name": "Elbise"
},
"url": "https://www.trendyol.com/tayt-vegas/eldivenli-elbise-p-901692264",
"price": {
"current": 1500,
"original": 1500,
"currency": "TRY"
},
"rating": {
"average": 4.603576751117735,
"count": 671
},
"color": "Bordo",
"size_shown": "S",
"images": [
"https://cdn.dsmcdn.com/ty1643/prod/QC/20250223/12/34bd887f-a2e9-3e9b-9bd2-a21f3326f8a9/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty1643/prod/QC/20250223/12/fad649e4-89d9-3d1e-a702-4f8b48867b12/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty1641/prod/QC/20250223/12/7f693592-6bdb-3be2-811f-94665de873d4/1_org_zoom.jpg"
],
"free_shipping": true,
"sold_out": false,
"is_sponsored": true,
"promotions": [
"2 Adet ve Üzeri %5 İndirim"
],
"group_id": 689874545
},
{
"position": 3,
"id": "994938191",
"name": "Tek Omuz Boyunlu Zarif Dökümlü Kahverengi Maxi Elbise",
"brand": {
"id": 2615974,
"name": "Dilay Gökoğlu Butik"
},
"seller_id": 1107503,
"category": {
"id": 1182,
"name": "Elbise"
},
"url": "https://www.trendyol.com/dilay-gokoglu-butik/tek-omuz-boyunlu-zarif-dokumlu-kahverengi-maxi-elbise-p-994938191",
"price": {
"current": 1421.44,
"original": 1421.44,
"currency": "TRY"
},
"rating": {
"average": 4.653566229985444,
"count": 687
},
"color": "Kahverengi",
"size_shown": "XL",
"images": [
"https://cdn.dsmcdn.com/ty1765/prod/QC_PREP/20250930/23/a9b47cf6-0567-3e4c-9bfd-fe33823e915a/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty1818/prod/QC_ENRICHMENT/20260131/14/40dd50d3-158e-3fc6-8659-c6484bc4960b/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty1765/prod/QC_PREP/20250930/23/b904f4c2-f780-37d5-82b7-9a814a0b2857/1_org_zoom.jpg"
],
"free_shipping": true,
"sold_out": false,
"is_sponsored": true,
"promotions": [
"2 Adet ve Üzeri 30 TL İndirim",
"3 Adet ve Üzeri 80 TL İndirim"
],
"group_id": 758825955
}
]position,id,name,brand,seller_id,category,url,price,rating,color,size_shown,images,free_shipping,sold_out,is_sponsored,group_id
1,1090399394,Siyah Kadın Dik Yaka Toka Detaylı Kuşaklı Toparlayıcı Kalıp Mini Elbise,"{""id"":997056,""name"":""World Fashion Trends""}",868610,"{""id"":1182,""name"":""Elbise""}",https://www.trendyol.com/world-fashion-trends/siyah-kadin-dik-yaka-toka-detayli-kusakli-toparlayici-kalip-mini-elbise-p-1090399394,"{""current"":431.1,""original"":431.1,""currency"":""TRY""}","{""average"":4.361393323657475,""count"":1378}",Siyah,XS,"[""https://cdn.dsmcdn.com/ty2012/prod/QC_ENRICHMENT/20261109/09/86f6fca7-760f-3f9a-9c42-e65aac007386/1_org_zoom.jpg"",""https://cdn.dsmcdn.com/ty2013/prod/QC_ENRICHMENT/20261109/09/a5afcd0a-9fb6-3f47-baff-d88c70ea5665/1_org_zoom.jpg"",""https://cdn.dsmcdn.com/ty2011/prod/QC_ENRICHMENT/20261109/09/38c52839-e4d3-3a11-9020-46b2a4b29020/1_org_zoom.jpg""]",true,false,true,829511467
2,901692264,ELDİVENLİ ELBİSE,"{""id"":962101,""name"":""TAYT VEGAS""}",460508,"{""id"":1182,""name"":""Elbise""}",https://www.trendyol.com/tayt-vegas/eldivenli-elbise-p-901692264,"{""current"":1500,""original"":1500,""currency"":""TRY""}","{""average"":4.603576751117735,""count"":671}",Bordo,S,"[""https://cdn.dsmcdn.com/ty1643/prod/QC/20250223/12/34bd887f-a2e9-3e9b-9bd2-a21f3326f8a9/1_org_zoom.jpg"",""https://cdn.dsmcdn.com/ty1643/prod/QC/20250223/12/fad649e4-89d9-3d1e-a702-4f8b48867b12/1_org_zoom.jpg"",""https://cdn.dsmcdn.com/ty1641/prod/QC/20250223/12/7f693592-6bdb-3be2-811f-94665de873d4/1_org_zoom.jpg""]",true,false,true,689874545
3,994938191,Tek Omuz Boyunlu Zarif Dökümlü Kahverengi Maxi Elbise,"{""id"":2615974,""name"":""Dilay Gökoğlu Butik""}",1107503,"{""id"":1182,""name"":""Elbise""}",https://www.trendyol.com/dilay-gokoglu-butik/tek-omuz-boyunlu-zarif-dokumlu-kahverengi-maxi-elbise-p-994938191,"{""current"":1421.44,""original"":1421.44,""currency"":""TRY""}","{""average"":4.653566229985444,""count"":687}",Kahverengi,XL,"[""https://cdn.dsmcdn.com/ty1765/prod/QC_PREP/20250930/23/a9b47cf6-0567-3e4c-9bfd-fe33823e915a/1_org_zoom.jpg"",""https://cdn.dsmcdn.com/ty1818/prod/QC_ENRICHMENT/20260131/14/40dd50d3-158e-3fc6-8659-c6484bc4960b/1_org_zoom.jpg"",""https://cdn.dsmcdn.com/ty1765/prod/QC_PREP/20250930/23/b904f4c2-f780-37d5-82b7-9a814a0b2857/1_org_zoom.jpg""]",true,false,true,758825955Recorded from our API · 3 items shown · 16 datapoints per itemGET /v1/trendyol/search?query=elbise
16 datapoints
Identity
- idstring
- namestring
- brandobject
- categoryobject
- group_idinteger
Contact
- seller_idinteger
- urlurl
Reputation
- ratingobject
- imagesstring[]
Price
- priceobject
Other
- positioninteger
- colorstring
- size_shownstring
- free_shippingboolean
- sold_outboolean
- is_sponsoredboolean
Playground
Run this API
curl "https://api.perceptlayer.com/v1/trendyol/search?query=elbise" \
-H "X-API-Key: $API_KEY"Trendyol · 4 endpoints
Endpoints
Every endpoint takes the same key. Open one for its parameters and an example request.
| Endpoint | Required parameters | Cost |
|---|---|---|
GET/v1/trendyol/filters | query | 1 credit |
GET/v1/trendyol/product | none+2 optional | 1 credit |
GET/v1/trendyol/reviews | id+1 optional | 1 credit |
GET/v1/trendyol/search | query+9 optional | 1 credit |
Overview
About the Trendyol API
What you can get
The Trendyol API returns Trendyol marketplace data as JSON through 4 endpoints.
- Search:
searchtakes aquery, withpage,sort(relevance, price_asc, price_desc, newest, best_seller, most_favorited or most_rated),brand_id,category_id,gender(women, men or kids),color,min_price,max_priceandmin_rating(1, 2, 3, 4 or 4.5). - Filters:
filterstakes aqueryand returns the filters available for it. - Products:
producttakes anidor a producturl.reviewstakes anid, withpage.
The recorded search for "elbise" returns items, each with position, id, name, brand, seller_id, category, url, price (current, original and currency), rating (average and count), color, size_shown, images, free_shipping, sold_out and is_sponsored. It also returns page, per_page, total_results, total_capped and has_next_page.
How a call works
Search, then look up: GET /v1/trendyol/search?query=elbise&sort=price_asc with your key in the X-API-Key header. Each result carries an id; product and reviews take that id. Check has_next_page before asking for the next page. Every successful call costs 1 credit; failed calls cost nothing.
More marketplaces APIs
Use cases
Track prices and discounts for a product list on Trendyol
Use the Trendyol API to track prices and discounts for a product list on TrendyolWatch whether products sell out
Use the Trendyol API to watch whether products sell outCompare sellers and brands within a category with `brand_id` and `category_id`
Use the Trendyol API to compare sellers and brands within a category with `brand_id` and `category_id`Read product reviews page by page
Use the Trendyol API to read product reviews page by pageFAQ
Questions
How much does the Trendyol API cost?
Each successful call costs one credit, and each search page is one call. New accounts get free credits to start, and credit packs bring the price down as you scale.
Do I need a Trendyol account?
No. You call this Trendyol API with your Perceptlayer key in the `X-API-Key` header, with no Trendyol login.
Can I filter by rating or price?
Yes. Pass `min_rating`, `min_price` and `max_price` to `search`, or sort with `sort=price_asc` or `sort=price_desc`.
What format are responses in?
Every endpoint returns JSON, with no HTML parsing on your side.
Should I build a Trendyol scraper instead?
You can, but a Trendyol scraper is code you maintain: page changes break it, requests get blocked, and Trendyol's terms govern how you collect data. The Trendyol API gives you 4 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.
Try the Trendyol API with 100 free credits
No credit card. Failed calls are never billed.