Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / Mytheresa

1 credit per call3 endpoints18 datapoints

Mytheresa API

Mytheresa API for luxury product search by designer, size and colour, sizes in stock, designer lists and product details as JSON. 1 credit per successful call.

Get a free API keyRun it below
Mytheresa
GET/v1/mytheresa/search?designer=Gucci&size_per_page=24&country=DE
{
  "success": true,
  "data": {
    "items": [
      {
        "sku": "P01262684",
        "slug": "gucci-feather-trimmed-jersey-top-black-p01262684",
        "url": "https://www.mytheresa.com/de/en/women/gucci-feather-trimmed-jersey-top-black-p01262684",
        "name": "Feather-trimmed jersey crop top",
        "designer": {
          "name": "Gucci",
          "id": "000919",
          "slug": "designers/gucci"
        },
        "description": "Gucci captures a bold and distinctive aesthetic, continually redefining the boundaries of contemporary luxury fashion. Expertly crafted in Italy from jersey, this crop top features a sleek short-sleeved silhouette that is beautifully accent…",
        "color": "black",
        "category": [
          "Clothing",
          "Tops",
          "Cropped"
        ],
        "price": {
          "amount": 890,
          "currency": "EUR"
        },
        "on_sale": false,
        "includes_vat": true,
        "vat_percent": 19,
        "images": [
          "https://img.mytheresa.com/1200/1200/66/jpeg/catalog/product/64/P01262684.jpg?image_c_version=2026-10-20T07%3A27%3A59.163Z",
          "https://img.mytheresa.com/1200/1200/66/jpeg/catalog/product/64/P01262684_b1.jpg?image_c_version=2026-10-19T08%3A23%3A42.153Z"
        ],
        "labels": [
          "new season"
        ],
        "in_stock": true,
        "purchasable": true,
        "seller_origin": "myt",
        "variants": [
          {
            "size": "XXS",
            "size_harmonized": "DE 32",
            "sku": "P01262684-2",
            "in_stock": true,
            "stock_hint": 3,
            "price": "…"
          },
          {
            "size": "XS",
            "size_harmonized": "DE 34",
            "sku": "P01262684-3",
            "in_stock": true,
            "price": "…"
          },
          {
            "size": "S",
            "size_harmonized": "DE 36",
            "sku": "P01262684-1",
            "in_stock": true,
            "price": "…"
          }
        ]
      },
      {
        "sku": "P01257578",
        "slug": "gucci-gucci-infinity-large-leather-shoulder-bag-black-p01257578",
        "url": "https://www.mytheresa.com/de/en/women/gucci-gucci-infinity-large-leather-shoulder-bag-black-p01257578",
        "name": "Gucci Infinity Large leather shoulder bag",
        "designer": {
          "name": "Gucci",
          "id": "000919",
          "slug": "designers/gucci"
        },
        "description": "Rooted in Italian heritage, Gucci shapes the landscape of modern luxury with its distinctive aesthetic. The Gucci Infinity Large shoulder bag is made in Italy from supple leather, featuring a slouchy silhouette, a single top handle, and a g…",
        "color": "black",
        "category": [
          "Bags",
          "Shoulder Bags"
        ],
        "price": {
          "amount": 1750,
          "currency": "EUR"
        },
        "on_sale": false,
        "includes_vat": true,
        "vat_percent": 19,
        "images": [
          "https://img.mytheresa.com/1200/1200/66/jpeg/catalog/product/e9/P01257578.jpg?image_c_version=2026-10-30T07%3A08%3A04.743Z",
          "https://img.mytheresa.com/1200/1200/66/jpeg/catalog/product/e9/P01257578_b1.jpg?image_c_version=2026-10-30T10%3A45%3A03.347Z"
        ],
        "labels": [
          "new",
          "new season"
        ],
        "in_stock": true,
        "purchasable": true,
        "seller_origin": "myt",
        "variants": [
          {
            "size": "-",
            "sku": "P01257578-1",
            "in_stock": true,
            "price": "…"
          }
        ]
      },
      {
        "sku": "P01188588",
        "slug": "gucci-snake-print-straight-pants-beige-p01188588",
        "url": "https://www.mytheresa.com/de/en/women/gucci-snake-print-straight-pants-beige-p01188588",
        "name": "Snake-print skinny pants",
        "designer": {
          "name": "Gucci",
          "id": "000919",
          "slug": "designers/gucci"
        },
        "description": "Gucci's designs perfectly balance a reverence for the past with a bold vision for the future. Featuring a skinny silhouette, these pants are defined by their snake print.",
        "color": "beige",
        "category": [
          "Clothing",
          "Pants",
          "Skinny"
        ],
        "price": {
          "amount": 980,
          "currency": "EUR"
        },
        "on_sale": false,
        "includes_vat": true,
        "vat_percent": 19,
        "images": [
          "https://img.mytheresa.com/1200/1200/66/jpeg/catalog/product/81/P01188588.jpg?image_c_version=2026-07-02T14%3A32%3A12.917Z",
          "https://img.mytheresa.com/1200/1200/66/jpeg/catalog/product/81/P01188588_b1.jpg?image_c_version=2026-07-07T07%3A11%3A14.16Z"
        ],
        "in_stock": true,
        "purchasable": true,
        "seller_origin": "myt",
        "variants": [
          {
            "size": "XXS",
            "size_harmonized": "DE 32",
            "sku": "P01188588-2",
            "in_stock": true,
            "stock_hint": 1,
            "price": "…"
          },
          {
            "size": "XS",
            "size_harmonized": "DE 34",
            "sku": "P01188588-3",
            "in_stock": true,
            "stock_hint": 2,
            "price": "…"
          },
          {
            "size": "S",
            "size_harmonized": "DE 36",
            "sku": "P01188588-1",
            "in_stock": true,
            "stock_hint": 1,
            "price": "…"
          }
        ]
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 24,
      "total": 1090,
      "total_pages": 46,
      "has_more": true
    },
    "sort": "recommendation",
    "filters": {
      "gender": "women",
      "designer": "Gucci",
      "sale_only": false
    },
    "country": "DE",
    "currency": "EUR"
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_4bbff35f6a6c4795896e37702d3b634d",
    "credits_charged": 1,
    "credits_remaining": 1914
  }
}
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.

#skustringslugstringurlurlnamestringdesignerobjectdescriptionstringcolorstringcategorystring[]priceobjecton_salebooleanincludes_vatbooleanvat_percentintegerimagesstring[]labelsstring[]in_stockbooleanpurchasablebooleanseller_originstringvariantsobject[]
1P01262684gucci-feather-trimmed-jersey-top-black-p01262684https://www.mytheresa.com/de/en/women/gucci-feather-trimmed-jersey-top-black-p01262684Feather-trimmed jersey crop top{3 fields}Gucci captures a bold and distinctive aesthetic, continually redefining the boundaries of contemporary luxury fashion. Expertly crafted in Italy from jersey, this crop top features a sleek short-sleeved silhouette that is beautifully accent…black[3 items]{2 fields}falsetrue19[2 items][1 item]truetruemyt[3 items]
2P01257578gucci-gucci-infinity-large-leather-shoulder-bag-black-p01257578https://www.mytheresa.com/de/en/women/gucci-gucci-infinity-large-leather-shoulder-bag-black-p01257578Gucci Infinity Large leather shoulder bag{3 fields}Rooted in Italian heritage, Gucci shapes the landscape of modern luxury with its distinctive aesthetic. The Gucci Infinity Large shoulder bag is made in Italy from supple leather, featuring a slouchy silhouette, a single top handle, and a g…black[2 items]{2 fields}falsetrue19[2 items][2 items]truetruemyt[1 item]
3P01188588gucci-snake-print-straight-pants-beige-p01188588https://www.mytheresa.com/de/en/women/gucci-snake-print-straight-pants-beige-p01188588Snake-print skinny pants{3 fields}Gucci's designs perfectly balance a reverence for the past with a bold vision for the future. Featuring a skinny silhouette, these pants are defined by their snake print.beige[3 items]{2 fields}falsetrue19[2 items]—truetruemyt[3 items]

Recorded from our API · 3 items shown · 18 datapoints per itemGET /v1/mytheresa/search?designer=Gucci&size_per_page=24&country=DE

18 datapoints

Identity

  • skustring
  • slugstring
  • namestring
  • categorystring[]

Contact

  • urlurl
  • seller_originstring

Reputation

  • imagesstring[]

Price

  • priceobject

Other

  • designerobject
  • descriptionstring
  • colorstring
  • on_saleboolean
  • includes_vatboolean
  • vat_percentinteger
  • labelsstring[]
  • in_stockboolean
  • purchasableboolean
  • variantsobject[]

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/mytheresa/search?designer=Gucci&size_per_page=24&country=DE" \
  -H "X-API-Key: $API_KEY"

Mytheresa · 3 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/mytheresa/designers
none+2 optional
1 credit
GET/v1/mytheresa/product
none+4 optional
1 credit
GET/v1/mytheresa/search
none+10 optional
1 credit

Overview

What you can get

The Mytheresa API returns Mytheresa product data as JSON through 3 endpoints. Each takes an optional country (DE, US, GB or FR) and gender (women, men or kids).

  • Search: search takes a designer, with category, sale_only, size, color, sort (recommendation, new_item, price_asc or price_desc), page and size_per_page.
  • Designers: designers lists the designers for a country and gender.
  • Products: product takes a url or a slug.

The recorded search for designer=Gucci in DE with size_per_page=24 returns items, each with sku, slug, url, name, designer, description, color, category, price, on_sale, includes_vat, vat_percent, images, in_stock, purchasable and variants (each with size, sku, in_stock and stock_hint). It also returns pagination with total (1,090 in that recording), total_pages and has_more, and the country and currency.

How a call works

Search a designer: GET /v1/mytheresa/search?designer=Gucci&size_per_page=24&country=DE with your key in the X-API-Key header. Use designers to list the designers first. Each result carries a slug, which product takes. Every successful call costs 1 credit; failed calls cost nothing.

MarketplacesJSONRESTMCP

More marketplaces APIs

About YouadidasAliExpressAllegroAmazonASOSBilliger.debol.comChrono24CostcoCraigslistDBA

Use cases

Track a designer's prices and sale status by country

Use the Mytheresa API to track a designer's prices and sale status by country

Check which sizes of a product are in stock

Use the Mytheresa API to check which sizes of a product are in stock

Watch new arrivals for a designer with `sort=new_item`

Use the Mytheresa API to watch new arrivals for a designer with `sort=new_item`

Compare prices across DE, US, GB and FR

Use the Mytheresa API to compare prices across DE, US, GB and FR

FAQ

Questions

How much does the Mytheresa 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.

Can I see which sizes are in stock?

Yes. Each product has `variants`, each with a `size` and `in_stock`.

Do I need a Mytheresa account?

No. You call this Mytheresa API with your Perceptlayer key in the `X-API-Key` header, with no Mytheresa login.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Should I build a Mytheresa scraper instead?

You can, but a Mytheresa scraper is code you maintain: page changes break it, requests get blocked, and Mytheresa's terms govern how you collect data. The Mytheresa API gives you 3 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 Mytheresa API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs