# Mytheresa Product API Documentation

<p><strong>Mytheresa Product API Documentation</strong> Read one Mytheresa product by slug or url. The item has the price, list price and discount, every size with its harmonized label, SKU, availability and a stock hint, the features with materials and origin, size and fit notes, large photos and the product url in every store. Mytheresa shows no rating or review count, so none is returned. Mytheresa limits how often its listing and search answer. Scrappa repeats the lookup for you for up to about 45 seconds. If Mytheresa still refuses, you get a 503 that costs nothing. Retry later. Cost: 1 credit per request, only for successful requests. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/mytheresa-api/mytheresa_product](https://scrappa.co/docs/mytheresa-api/mytheresa_product)
- **API group:** Mytheresa API
- **Endpoint:** `GET https://scrappa.co/api/mytheresa/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 |
| --- | --- | --- | --- |
| `slug` | string | No | Product slug as the search returns it, for example gucci-jordaan-gg-suede-loafers-black-p01250900. A bare SKU is not accepted. |
| `url` | string | No | Mytheresa product url ending in -p followed by digits. Send this or slug. |
| `country` | string | No | Store: DE (EUR, default), US (USD), GB (GBP) or FR (EUR). |
| `gender` | string | No | women (default), men or kids. |

## Example response

```json
{
    "data": {
        "item": {
            "sku": "P01250900",
            "url": "https://www.mytheresa.com/de/en/women/gucci-jordaan-gg-suede-loafers-black-p01250900",
            "name": "Jordaan GG suede loafers",
            "slug": "gucci-jordaan-gg-suede-loafers-black-p01250900",
            "color": "black",
            "price": {
                "amount": 890,
                "currency": "EUR"
            },
            "images": [
                "https://img.mytheresa.com/1200/1200/66/jpeg/catalog/product/ac/P01250900.jpg?image_c_version=2026-10-14T14%3A38%3A20.663Z",
                "https://img.mytheresa.com/1200/1200/66/jpeg/catalog/product/ac/P01250900_b1.jpg?image_c_version=2026-10-15T12%3A32%3A08.257Z"
            ],
            "labels": [],
            "on_sale": false,
            "category": [
                "Shoes",
                "Loafers"
            ],
            "designer": {
                "id": "000919",
                "name": "Gucci",
                "slug": "designers/gucci"
            },
            "features": [
                "Upper: leather (suede)",
                "Lining: leather",
                "Sole: leather insole and sole"
            ],
            "in_stock": true,
            "variants": [
                {
                    "sku": "P01250900-1",
                    "size": "34",
                    "price": {
                        "amount": 890,
                        "currency": "EUR"
                    },
                    "in_stock": true,
                    "stock_hint": 1,
                    "size_harmonized": "EU 34"
                },
                {
                    "sku": "P01250900-2",
                    "size": "35",
                    "price": {
                        "amount": 890,
                        "currency": "EUR"
                    },
                    "in_stock": true,
                    "stock_hint": 2,
                    "size_harmonized": "EU 35"
                }
            ],
            "description": "Gucci continues to shape the landscape of modern luxury through its distinctive archival codes. Crafted in Italy from ta",
            "purchasable": true,
            "vat_percent": 19,
            "includes_vat": true,
            "size_and_fit": [
                "True to size",
                "European sizes"
            ],
            "seller_origin": "myt",
            "alternate_urls": [
                {
                    "url": "https://www.mytheresa.com/de/en/women/gucci-jordaan-gg-suede-loafers-black-p01250900",
                    "store": "DE",
                    "language": "en"
                },
                {
                    "url": "https://www.mytheresa.com/de/de/damen/gucci-loafers-jordaan-gg-aus-veloursleder-schwarz-p01250900",
                    "store": "DE",
                    "language": "de"
                }
            ],
            "original_price": null,
            "sizes_on_stock": [
                {
                    "size": "EU 34",
                    "level": "low",
                    "in_stock": true
                },
                {
                    "size": "EU 35",
                    "level": "low",
                    "in_stock": true
                }
            ],
            "discount_percent": null
        },
        "country": "DE",
        "currency": "EUR"
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "product"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | No product has this slug. This response is not billable. |
| 503 | Upstream Unavailable | The store did not answer or sent a page Scrappa cannot read. This response is not billable. Retry later. |

## 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)
