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.
- **Documentation:** [https://scrappa.co/docs/trendyol-api/trendyol_search](https://scrappa.co/docs/trendyol-api/trendyol_search) - **API group:** Trendyol API - **Endpoint:** `GET https://scrappa.co/api/trendyol/search` ## Authentication Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key. ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `query` | string | Yes | Search text, 1 to 120 characters, for example elbise. | | `page` | integer | No | One-based page number, 1 to 500 (default 1). 36 results per page. | | `sort` | string | No | One of relevance, price_asc, price_desc, newest, best_seller, most_favorited, most_rated. | | `brand_id` | integer | No | 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. | | `gender` | string | No | One of women, men, kids. | | `color` | string | No | Color name in Turkish, for example siyah or lacivert. The Filters API lists all colors. | | `category_id` | integer | No | Category id from the Trendyol Filters API. | | `min_price` | number | No | Lowest price in TRY. | | `max_price` | number | No | Highest price in TRY. | | `min_rating` | string | No | Lowest average rating: 1, 2, 3, 4 or 4.5. | ## Example response ```json { "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 | Status | Error | Description | | --- | --- | --- | | 422 | Validation Error | A required parameter or a value is invalid. This response is not billable. | | 503 | Upstream Unavailable | Trendyol could not be reached after several tries. This response is not billable. Retry shortly. | ## More Scrappa resources - [API documentation](https://scrappa.co/docs) - [Full LLM-readable API reference](https://scrappa.co/llms-full.txt) - [OpenAPI specification](https://scrappa.co/docs/api.json) - [Pricing](https://scrappa.co/pricing)