# Trendyol Product API Documentation

<p><strong>Trendyol Product API</strong> returns one product: price in TRY with original price and discount, sizes with stock and barcode and the price of each size, brand, gender, category path, color, full size images, description, rating, review count, favorite count, free shipping flag, stock limits and the seller id, name and score.</p><p>Send <code>id</code> (the product number from search) or <code>url</code> (a Trendyol product link). The data comes from the Turkish storefront, so prices are always TRY. A product that does not exist returns 404.</p><p>Costs 1 credit per successful request. Failed requests are free.</p>

- **Documentation:** [https://scrappa.co/docs/trendyol-api/trendyol_product](https://scrappa.co/docs/trendyol-api/trendyol_product)
- **API group:** Trendyol API
- **Endpoint:** `GET https://scrappa.co/api/trendyol/product`

## 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 |
| --- | --- | --- | --- |
| `id` | string | No | Product number from search, 4 to 12 digits, for example 1167699402. Send id or url. |
| `url` | string | No | A product page link on trendyol.com that ends with -p- and the product number. Send id or url. |

## Example response

```json
{
    "data": {
        "product": {
            "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
            },
            "stock": {
                "status": 1,
                "is_running_out": false,
                "max_sale_limit": 11,
                "running_out_quantity": 0
            },
            "gender": "Kad\u0131n",
            "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,
                "review_count": 19
            },
            "seller": {
                "id": 1297286,
                "name": "BRIGELLE",
                "score": 8.4
            },
            "category": {
                "id": 1182,
                "name": "Elbise",
                "path": [
                    "Giyim",
                    "Elbise"
                ]
            },
            "in_stock": true,
            "variants": [
                {
                    "size": "S",
                    "price": 689,
                    "barcode": "8697451201046",
                    "currency": "TRY",
                    "in_stock": true,
                    "item_number": 1635976967
                },
                {
                    "size": "M",
                    "price": 689,
                    "barcode": "8697451201045",
                    "currency": "TRY",
                    "in_stock": true,
                    "item_number": 1635976970
                },
                {
                    "size": "L",
                    "price": 689,
                    "barcode": "8697451201044",
                    "currency": "TRY",
                    "in_stock": true,
                    "item_number": 1635976968
                }
            ],
            "description": "K\u0131sa elbise\n%100 Polyester",
            "free_shipping": true,
            "favorite_count": 24777
        }
    },
    "meta": {
        "credits": 10,
        "billable": true,
        "endpoint_family": "product"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a value is invalid. This response is not billable. |
| 404 | Not Found | The product does not exist on Trendyol. 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)