Trendyol Search API searches fashion products on Trendyol (Turkey). Each item has the current price, the original price and the discount in percent as numbers in TRY, brand, seller id, category, rating, color, full size images, free shipping and sold out flags, and the active promotions.
Filter by brand (brand_id), gender, color, category (category_id), price range, minimum rating and sort order. Read the ids of brands and categories from the Trendyol Filters API. Every item in the answer follows the filters you send.
There are 36 results per page. total_results is capped at 100000 and total_capped says so. Page N returns the real page N. A size filter does not exist: size returns 422. Read sizes with stock from the Trendyol Product API.
Costs 1 credit per successful request. Empty results and failed requests are free.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
9 optional filters available.
string
Required
Search text, 1 to 120 characters, for example elbise.
coffee shops
integer
Optional
One-based page number, 1 to 500 (default 1). 36 results per page.
1
string
Optional
One of relevance, price_asc, price_desc, newest, best_seller, most_favorited, most_rated.
relevance
integer
Optional
Brand id from the Trendyol Filters API (/api/trendyol/filters), for example 41 for MANGO. The brand.id on a search item is a different id; do not use it here.
1234567890
string
Optional
One of women, men, kids.
example
string
Optional
Color name in Turkish, for example siyah or lacivert. The Filters API lists all colors.
example
integer
Optional
Category id from the Trendyol Filters API.
1234567890
number
Optional
Lowest price in TRY.
10
number
Optional
Highest price in TRY.
10
string
Optional
Lowest average rating: 1, 2, 3, 4 or 4.5.
example
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"page": 1,
"items": [
{
"id": "1167699402",
"url": "https://www.trendyol.com/blue-street/kadin-kollari-bol-vucuda-oturan-slim-kisa-elbise-p-1167699402",
"name": "Kad\u0131n Kollar\u0131 Bol V\u00fccuda Oturan Slim K\u0131sa Elbise",
"brand": {
"id": 2391838,
"name": "BLUE STREET"
},
"color": "Siyah",
"price": {
"current": 689,
"currency": "TRY",
"original": 737.99,
"discount_percent": 6.6
},
"images": [
"https://cdn.dsmcdn.com/ty1891/prod/QC_PREP/20260711/13/29d94a5d-fad0-3506-a05f-867e74c48a98/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty1898/prod/QC_PREP/20260711/13/6a737cfb-face-3029-99dd-013b254bf1a6/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty1906/prod/QC_PREP/20260711/13/7f3e5b33-ec8a-31b8-99de-bb5988c7cef9/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty1900/prod/QC_PREP/20260711/13/88eb96e4-56db-351c-90e7-f76428d504a9/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty1934/prod/QC_PREP/20260711/13/9df4af63-7e9a-3180-af89-e4f8669f93ee/1_org_zoom.jpg"
],
"rating": {
"count": 32,
"average": 3.4375
},
"category": {
"id": 1182,
"name": "Elbise"
},
"group_id": 896286927,
"position": 1,
"sold_out": false,
"seller_id": 1297286,
"promotions": [],
"size_shown": "S",
"is_sponsored": true,
"free_shipping": true
},
{
"id": "1158671286",
"url": "https://www.trendyol.com/marcelle-leandra/etoile-dress-ozel-tasarim-mini-elbise-p-1158671286",
"name": "\u00c9toile Dress \u00d6zel Tasar\u0131m Mini Elbise",
"brand": {
"id": 2906746,
"name": "Marcelle Leandra"
},
"color": "Siyah",
"price": {
"current": 1924.72,
"currency": "TRY",
"original": 1924.72,
"discount_percent": null
},
"images": [
"https://cdn.dsmcdn.com/ty1927/prod/QC_PREP/20260619/22/da0907c8-d757-31ab-9ed1-514fb4724b7c/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty1909/prod/QC_PREP/20260619/22/18aea89f-611a-309f-897b-7cb3b229e83e/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty1936/prod/QC_PREP/20260619/22/a77d414c-2d4b-399d-86b6-4943fcc7a9f3/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty1927/prod/QC_ENRICHMENT/20260707/15/71e06b63-a1ca-38f1-adbc-30024de543c2/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty1927/prod/QC_ENRICHMENT/20260715/23/4a84fe31-f07a-3d84-8f1b-f3e5075420e3/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty1988/prod/QC_ENRICHMENT/20261023/15/3474aa58-ee99-308a-b511-38bf1bc472ef/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty1988/prod/QC_ENRICHMENT/20261023/15/95029ff0-62d4-3cb3-a4f9-7375c1db1ebb/1_org_zoom.jpg",
"https://cdn.dsmcdn.com/ty1986/prod/QC_ENRICHMENT/20261023/15/1f803fe7-59c1-3d8b-af49-340ad7148294/1_org_zoom.jpg"
],
"rating": {
"count": 4,
"average": 4
},
"category": {
"id": 1182,
"name": "Elbise"
},
"group_id": 888570257,
"position": 2,
"sold_out": false,
"seller_id": 1203892,
"promotions": [
"Sepette %11 \u0130ndirim"
],
"size_shown": "S",
"is_sponsored": true,
"free_shipping": true
}
],
"query": "elbise",
"per_page": 36,
"total_capped": true,
"has_next_page": true,
"total_results": 100000
},
"meta": {
"credits": 1,
"billable": true,
"endpoint_family": "search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required parameter or a value is invalid. This response is not billable.
{
"errors": {
"size": [
"Trendyol does not offer a size filter in this API. Search without size, then read the sizes with stock from the product endpoint."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Trendyol could not be reached after several tries. This response is not billable. Retry shortly.
{
"meta": {
"credits": 0,
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Trendyol could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.