--- title: "Trendyol API: JSON data, 4 endpoints, 1 credit per call" description: "Trendyol API for product search with price, rating and gender filters, search filters, product details and reviews as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/trendyol --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / Trendyol 1 credit per call 4 endpoints 16 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. [Get a free API key](https://perceptlayer.com/signup) Run it below Trendyol GET /v1/trendyol/search?query=elbise ``` { "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 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | position integer | id string | name string | brand object | seller\_id integer | category object | url url | price object | rating object | color string | size\_shown string | images string\[\] | free\_shipping boolean | sold\_out boolean | is\_sponsored boolean | group\_id integer | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 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 | Recorded from our API · 3 items shown · 16 datapoints per item GET /v1/trendyol/search?query=elbise 16 datapoints ### Identity - id string - name string - brand object - category object - group\_id integer ### Contact - seller\_id integer - url url ### Reputation - rating object - images string\[\] ### Price - price object ### Other - position integer - color string - size\_shown string - free\_shipping boolean - sold\_out boolean - is\_sponsored boolean Playground ## Run this API cURL shell ``` 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`](https://perceptlayer.com/apis/trendyol/filters) | `query` | 1 credit | | [GET `/v1/trendyol/product`](https://perceptlayer.com/apis/trendyol/product) | none +2 optional | 1 credit | | [GET `/v1/trendyol/reviews`](https://perceptlayer.com/apis/trendyol/reviews) | `id` +1 optional | 1 credit | | [GET `/v1/trendyol/search`](https://perceptlayer.com/apis/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:** `search` takes a `query`, with `page`, `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_price` and `min_rating` (1, 2, 3, 4 or 4.5). - **Filters:** `filters` takes a `query` and returns the filters available for it. - **Products:** `product` takes an `id` or a product `url`. `reviews` takes an `id`, with `page`. 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. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) 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 Trendyol` ### Watch whether products sell out `Use the Trendyol API to watch whether products sell out` ### Compare 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 page` FAQ ## 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. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)