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.

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 OKJSONX-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.

#positionintegeridstringnamestringbrandobjectseller_idintegercategoryobjecturlurlpriceobjectratingobjectcolorstringsize_shownstringimagesstring[]free_shippingbooleansold_outbooleanis_sponsoredbooleangroup_idinteger
111090399394Siyah 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}SiyahXS[3 items]truefalsetrue829511467
22901692264ELDİVENLİ ELBİSE{2 fields}460508{2 fields}https://www.trendyol.com/tayt-vegas/eldivenli-elbise-p-901692264{3 fields}{2 fields}BordoS[3 items]truefalsetrue689874545
33994938191Tek 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}KahverengiXL[3 items]truefalsetrue758825955

Recorded 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

cURLshell
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.

EndpointRequired parametersCost
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: 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.

MarketplacesJSONRESTMCP

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 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.