Farfetch Product API Documentation Get one Farfetch product by id or product url. The answer has the title, description, designer, gender, category path, season, made in, designer style id (brand_style_id), style id, composition with material and percent, care instructions, colors, measurements, labels and all photos in full size. Prices follow the country you send: the price is the lowest price of the sizes in stock, with the original price and the discount. Every size is a variant with its label, size id, scale, quantity, in-stock flag, boutique id (merchant_id), price with and without taxes, original price and discount. Sizes that are sold out stay in the list with quantity 0. When Farfetch does not sell the product in the country, availability is unavailable_in_country, the variants are empty and the price is null: it is never shown as in stock. Farfetch shows no ratings or reviews, so none are returned. The boutique is returned as an id. Cost: 1 credit per request, only for successful requests.
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
The number at the end of a Farfetch product url, e.g. 39925614. Send the id or the url.
1234567890
string
Optional
A farfetch.com product url ending in -item-
https://example.com/product
string
Optional
Country of the prices and stock: DE (default), US, GB, FR, IT, ES, NL, JP, CA, AU, CH, AE, SE or CN. Each country has its own currency.
US
string
Optional
Optional. Must be the currency of the country: EUR for DE, FR, IT, ES and NL, USD, GBP, JPY, CAD, AUD, CHF, AED, SEK or CNY. Another currency gives a 422.
USD
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
meta
product
success
{
"meta": {
"billable": true,
"endpoint_family": "product"
},
"product": {
"id": 39925614,
"url": "https://www.farfetch.com/shopping/women/gucci-silk-dress-item-39925614.aspx",
"care": [
{
"value": "Dry Clean Only",
"instruction": "Washing Instructions"
}
],
"brand": {
"id": 25354,
"name": "Gucci"
},
"price": {
"amount": 4100,
"currency": "EUR"
},
"title": "silk day dress",
"colors": [
{
"id": 112495,
"name": "Black",
"type": "main"
}
],
"gender": "Woman",
"images": [
"https://cdn-images.farfetch-contents.com/39/92/56/14/39925614_86239393_1920.jpg"
],
"labels": [],
"season": "AW26",
"country": "DE",
"made_in": "Italy",
"style_id": 146876938,
"variants": [
{
"sku": "A1B2C3 42",
"size": "42",
"price": {
"amount": 4100,
"currency": "EUR"
},
"scale": "Italy",
"size_id": 21,
"in_stock": true,
"quantity": 1,
"tax_rate": 19,
"merchant_id": 16279,
"original_price": {
"amount": 4100,
"currency": "EUR"
},
"discount_percent": 0,
"price_excl_taxes": 3445.38,
"scale_abbreviation": "IT"
},
{
"sku": "A1B2C3 46",
"size": "46",
"price": {
"amount": 4100,
"currency": "EUR"
},
"scale": "Italy",
"size_id": 23,
"in_stock": false,
"quantity": 0,
"tax_rate": 19,
"merchant_id": 16279,
"original_price": {
"amount": 4100,
"currency": "EUR"
},
"discount_percent": 0,
"price_excl_taxes": 3445.38,
"scale_abbreviation": "IT"
}
],
"is_online": true,
"categories": [
{
"id": 141258,
"name": "Women"
},
{
"id": 135967,
"name": "Clothing"
},
{
"id": 135979,
"name": "Dresses"
},
{
"id": 136189,
"name": "Day Dresses"
}
],
"composition": [
{
"part": null,
"percent": 100,
"material": "Silk"
}
],
"description": "Silk dress with a belted waist.",
"uploaded_at": "2026-10-20T08:20:51.128+00:00",
"availability": "in_stock",
"measurements": [],
"category_path": [
"Women",
"Clothing",
"Dresses",
"Day Dresses"
],
"brand_style_id": "815218FAEAA",
"original_price": {
"amount": 4100,
"currency": "EUR"
},
"discount_percent": 0,
"variant_group_id": "815218FAEAA",
"preferred_merchant_id": 16279
},
"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": {
"country": [
"The country is one of DE, US, GB, FR, IT, ES, NL, JP, CA, AU, CH, AE, SE, CN."
]
},
"message": "The request validation failed"
}Product Not Found
Farfetch has no product with this id. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "product"
},
"error": {
"code": "NOT_FOUND",
"message": "Farfetch has no product for this id."
},
"success": false
}Service Unavailable
Farfetch did not answer. Retry shortly. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "product"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Farfetch is temporarily unavailable. 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.