--- title: "Mytheresa API: JSON data, 3 endpoints, 1 credit per call" description: "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." url: https://perceptlayer.com/apis/mytheresa --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / Mytheresa 1 credit per call 3 endpoints 18 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-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. | # | sku string | slug string | url url | name string | designer object | description string | color string | category string\[\] | price object | on\_sale boolean | includes\_vat boolean | vat\_percent integer | images string\[\] | labels string\[\] | in\_stock boolean | purchasable boolean | seller\_origin string | variants object\[\] | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | P01262684 | gucci-feather-trimmed-jersey-top-black-p01262684 | https://www.mytheresa.com/de/en/women/gucci-feather-trimmed-jersey-top-black-p01262684 | Feather-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} | false | true | 19 | \[2 items\] | \[1 item\] | true | true | myt | \[3 items\] | | 2 | P01257578 | gucci-gucci-infinity-large-leather-shoulder-bag-black-p01257578 | https://www.mytheresa.com/de/en/women/gucci-gucci-infinity-large-leather-shoulder-bag-black-p01257578 | Gucci 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} | false | true | 19 | \[2 items\] | \[2 items\] | true | true | myt | \[1 item\] | | 3 | P01188588 | gucci-snake-print-straight-pants-beige-p01188588 | https://www.mytheresa.com/de/en/women/gucci-snake-print-straight-pants-beige-p01188588 | Snake-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} | false | true | 19 | \[2 items\] | — | true | true | myt | \[3 items\] | Recorded from our API · 3 items shown · 18 datapoints per item GET /v1/mytheresa/search?designer=Gucci&size\_per\_page=24&country=DE 18 datapoints ### Identity - sku string - slug string - name string - category string\[\] ### Contact - url url - seller\_origin string ### Reputation - images string\[\] ### Price - price object ### Other - designer object - description string - color string - on\_sale boolean - includes\_vat boolean - vat\_percent integer - labels string\[\] - in\_stock boolean - purchasable boolean - variants object\[\] Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/mytheresa/designers`](https://perceptlayer.com/apis/mytheresa/designers) | none +2 optional | 1 credit | | [GET `/v1/mytheresa/product`](https://perceptlayer.com/apis/mytheresa/product) | none +4 optional | 1 credit | | [GET `/v1/mytheresa/search`](https://perceptlayer.com/apis/mytheresa/search) | none +10 optional | 1 credit | Overview ## About the Mytheresa API ## 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. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)