# Farfetch Product API Documentation

<p><strong>Farfetch Product API Documentation</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/farfetch-api/farfetch_product](https://scrappa.co/docs/farfetch-api/farfetch_product)
- **API group:** Farfetch API
- **Endpoint:** `GET https://scrappa.co/api/farfetch/product`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | No | The number at the end of a Farfetch product url, e.g. 39925614. Send the id or the url. |
| `url` | string | No | A farfetch.com product url ending in -item-<id>.aspx. Send the id or the url. |
| `country` | string | No | 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. |
| `currency` | string | No | 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. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 404 | Product Not Found | Farfetch has no product with this id. This response is not billable. |
| 503 | Service Unavailable | Farfetch did not answer. Retry shortly. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)