> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Farfetch Products API

> Farfetch product detail: price, discount, per-size availability, seller boutique and category. One row per product, from a designer or product URL.

`POST /v1/data/farfetch/products/run`

**Pricing:** $0.001 per product ($1.00 per 1,000).

## Ways to call it

* **Listing URL**: set `listing_url` (optional: `maxResults`)
* **Search**: set `query` (optional: `maxResults`)
* **Product URL**: set `urls`

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**listing\_url** `string`

A Farfetch designer or listing page URL, e.g. [https://www.farfetch.com/shopping/men/gucci/items.aspx](https://www.farfetch.com/shopping/men/gucci/items.aspx). Designer pages return that brand's catalog.

Format e.g. `https://www.farfetch.com/shopping/men/gucci/items.aspx`.

**query** `string`

A brand or keyword to look up, e.g. 'gucci'. We build the listing URL for you.

**urls** `string[]`

One or more Farfetch product URLs, e.g. [https://www.farfetch.com/shopping/men/gucci-jordaan-horsebit-loafers-item-19426833.aspx](https://www.farfetch.com/shopping/men/gucci-jordaan-horsebit-loafers-item-19426833.aspx). One per line.

**maxResults** `integer`

Number of products to return from a listing page. Use 0 for all. Ignored when you pass product URLs.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/farfetch/products/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "listing_url": "https://www.farfetch.com/shopping/men/gucci/items.aspx",
    "maxResults": 50
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/farfetch/products/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "listing_url": "https://www.farfetch.com/shopping/men/gucci/items.aspx",
    "maxResults": 50
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/farfetch/products/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "listing_url": "https://www.farfetch.com/shopping/men/gucci/items.aspx",
  "maxResults": 50
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one product, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `productId` | Product ID | text |
| `productName` | Product Name | text |
| `brand` | Brand | text |
| `productUrl` | Product URL | url |
| `description` | Description | text |
| `color` | Color | text |
| `category` | Category | text |
| `categoryPath` | Category Path | text |
| `gender` | Gender | text |
| `season` | Season | text |
| `price` | Price | number |
| `fullPrice` | Full Price | number |
| `discountPercent` | Discount Percent | number |
| `currency` | Currency | text |
| `seller` | Seller | text |
| `sizes` | Sizes | array |
| `variants` | Variants | object\_array |
| `measurements` | Measurements | object\_array |
| `returns` | Returns | object |
| `stockQuantity` | Stock Quantity | number |
| `availability` | Availability | array |
| `label` | Label | text |
| `condition` | Condition | text |
| `images` | Images | array |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "farfetch/products",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "productId": "35753540",
      "variants": [
        {
          "sku": "35753540-32",
          "size": "42",
          "available": "InStock",
          "price": 2279,
          "currency": "USD",
          "url": "https://www.farfetch.com/in/shopping/men/tag-heuer-connected-golf-42mm-smartwatch-item-35753540.aspx?lang=en-GB&size=32"
        }
      ],
      "season": "SS25",
      "images": [
        "https://cdn-images.farfetch-contents.com/35/75/35/40/35753540_67378525_1000.jpg",
        "https://cdn-images.farfetch-contents.com/35/75/35/40/35753540_67378513_1000.jpg"
      ],
      "discountPercent": null,
      "stockQuantity": 12,
      "condition": "New",
      "availability": [
        "AVAILABLE_FOR_PURCHASE"
      ],
      "brand": "TAG Heuer",
      "sizes": [
        "M"
      ],
      "fullPrice": 2279,
      "gender": "Man",
      "label": null,
      "seller": "STORK US",
      "description": "TAG Heuer Connected Golf 42mm smartwatch | Black | titanium | round-shaped 42mm case | digital display | fixed ceramic bezel | rubber strap | push-button fol...",
      "category": "Smartwatches",
      "measurements": null,
      "categoryPath": "Men > Watches > Fine Watches > Smartwatches",
      "color": "Black",
      "productName": "Connected Golf 42mm smartwatch",
      "productUrl": "https://www.farfetch.com/shopping/men/tag-heuer-connected-golf-42mm-smartwatch-item-35753540.aspx",
      "currency": "USD",
      "returns": {
        "days": 30,
        "method": "ReturnByMail",
        "fees": "FreeReturn"
      },
      "price": 2279
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.