mytheresa.com APImytheresa.com ↗
Access Mytheresa's luxury fashion catalog via API. Retrieve products, pricing, variants, designer listings, and images with pagination and category filtering.
curl -X GET 'https://api.parse.bot/scraper/48521b8f-a4c8-44fe-9aae-5b11cae45a10/get_men_catalog?page=1&size=5&slug=%2Fclothing' \ -H 'X-API-Key: $PARSE_API_KEY'
Get the clothing catalog with pagination. Returns product listings including pricing, variants, images, and facets for filtering.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| size | integer | Number of items per page. |
| slug | string | Category slug path (e.g. /clothing, /shoes, /bags, /clothing/jackets). |
{
"type": "object",
"fields": {
"listing": "object containing products array, pagination, facets, and sort options",
"metadata": "object containing page SEO metadata, content banners, and description"
},
"sample": {
"data": {
"listing": {
"sort": {
"params": [
"recommendation",
"new_item",
"price_asc"
],
"currentParam": "recommendation"
},
"facets": {
"designers": {
"options": [
{
"slug": "/designers/a-presse",
"count": 51,
"value": "A.Presse"
}
]
}
},
"products": [
{
"sku": "P01189004",
"name": "GG Canvas cotton jacket",
"slug": "/gucci-gg-canvas-cotton-jacket-beige-p01189004",
"price": {
"original": 275000,
"currencyCode": "USD"
},
"designer": "Gucci"
}
],
"pagination": {
"totalItems": 5910,
"totalPages": 493,
"currentPage": 1,
"itemsPerPage": 12
},
"displayName": "Clothing"
},
"metadata": {
"name": "Clothing",
"slug": "men/clothing",
"metadata": {
"title": "Men's Designer Clothes | Mytheresa"
}
}
},
"status": "success"
}
}About the mytheresa.com API
The Mytheresa API exposes 5 endpoints for accessing the men's luxury fashion catalog on mytheresa.com, covering product listings, designer directories, and full product details. The get_product_details endpoint returns over a dozen fields per item — including price with discount percentage, size variants with stock availability, materials, sustainability info, and multiple image URLs — identified by a product slug obtained from catalog or designer listing endpoints.
Catalog Browsing and Filtering
The get_men_catalog endpoint returns paginated product listings across Mytheresa's men's categories. Pass a slug parameter such as /clothing, /shoes, or /clothing/jackets to scope results to a subcategory. The listing response object includes a products array, pagination metadata, sort options, and facets for further filtering. The metadata object carries page-level SEO content and promotional banners. Both page and size parameters control pagination depth.
Designer Discovery and Filtering
get_men_designers returns a flat array of all designers present in the catalog, with each entry carrying a value (display name), count (number of products), and slug for use with get_men_designer_catalog. Passing a designer_slug like gucci or acne-studios to get_men_designer_catalog returns the same listing structure as the main catalog but scoped to that designer, including a designer bio in the metadata object.
Product Detail and Image Data
get_product_details accepts a product_slug — such as gucci-gg-canvas-cotton-jacket-beige-p01189004 — sourced from any catalog listing's slug field. The response includes sku, name, designer, description, features (materials and care), sizeAndFit, designerInfo (with designerId and designerSlug), a price object with currencyCode, original, discount, and percentage, and a variants array covering per-size stock and pricing. get_product_images returns the same product_id alongside a dedicated image_urls array when only image URLs are needed without the full detail payload.
Coverage Scope
All catalog, designer, and product endpoints currently cover the men's section of mytheresa.com. Product slugs are the consistent key linking listings to details — any slug returned in a get_men_catalog or get_men_designer_catalog products array is valid input for both get_product_details and get_product_images.
- Build a luxury menswear price tracker using the
priceobject fields — original, discount, and percentage — fromget_product_details. - Aggregate designer product counts across Mytheresa's catalog using
get_men_designersto benchmark brand presence. - Populate a comparison tool with variant-level stock and sizing data from the
variantsarray inget_product_details. - Feed a fashion recommendation engine with category-filtered listings from
get_men_catalogusing subcategory slugs like/shoesor/bags. - Sync product images into a digital asset pipeline using
get_product_imagesfor bulk image URL retrieval by product slug. - Analyze material and sustainability attributes across categories by extracting the
featuresarray from product detail responses. - Monitor a specific designer's catalog size and inventory over time by polling
get_men_designer_catalogwith a designer slug.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Mytheresa offer an official public developer API?+
What does `get_product_details` return beyond basic name and price?+
name and price, the endpoint returns sku, designer, description, a features array with material and care instructions, sizeAndFit descriptions, a designerInfo object with ID and slug, a variants array with per-size stock and pricing, and a displayImages array of image URLs.Can I filter the men's catalog by both category and designer at the same time?+
get_men_catalog accepts a category slug parameter and get_men_designer_catalog accepts a designer_slug parameter, but these are separate endpoints — there is no single endpoint that combines both filters simultaneously. The API covers category-scoped browsing and designer-scoped browsing as distinct queries. You can fork it on Parse and revise it to add a combined filter endpoint.Does the API cover the women's or kids' sections of Mytheresa?+
How fresh is the pricing and stock data returned by the product endpoints?+
price and variants fields in get_product_details reflect the state of the listing at the time the request is made. Luxury inventory and promotional pricing on Mytheresa can change frequently, so applications that depend on real-time availability or price accuracy should re-query per product rather than cache responses for extended periods.