Mytheresa Product API Documentation 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.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
4 optional filters available.
string
Optional
Product slug as the search returns it, for example gucci-jordaan-gg-suede-loafers-black-p01250900. A bare SKU is not accepted.
example
string
Optional
Mytheresa product url ending in -p followed by digits. Send this or slug.
https://example.com/product
string
Optional
Store: DE (EUR, default), US (USD), GB (GBP) or FR (EUR).
US
string
Optional
women (default), men or kids.
example
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"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
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A query parameter is missing or invalid. This response is not billable.
{
"errors": {
"slug": [
"Send a product url or a product slug."
]
},
"message": "The request validation failed"
}Not Found
No product has this slug. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "product"
},
"error": {
"code": "NOT_FOUND",
"message": "Mytheresa has no product with this slug."
},
"success": false
}Upstream Unavailable
The store did not answer or sent a page Scrappa cannot read. This response is not billable. Retry later.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "product"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.