Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / Farfetch

1 credit per call2 endpoints17 datapoints

Farfetch API

Farfetch API for luxury product search by designer, size and price in 14 countries, with sale prices and product details as JSON. 1 credit per successful call.

Get a free API keyRun it below
Farfetch
GET/v1/farfetch/search?country=DE&query=dress&designer[]=Gucci&gender=women&price_max=2000&sort=price_asc
{
  "success": true,
  "items": [
    {
      "id": 19909696,
      "url": "https://www.farfetch.com/de/shopping/women/gucci-polka-dot-one-shoulder-minidress-item-19909696.aspx",
      "title": "polka-dot one-shoulder minidress",
      "brand": {
        "id": 25354,
        "name": "Gucci"
      },
      "gender": "Woman",
      "price": {
        "amount": 840,
        "currency": "EUR"
      },
      "original_price": {
        "amount": 2100,
        "currency": "EUR"
      },
      "discount_percent": 60,
      "price_type": "sale",
      "images": [
        "https://cdn-images.farfetch-contents.com/19/90/96/96/19909696_54777410_800.jpg",
        "https://cdn-images.farfetch-contents.com/19/90/96/96/19909696_54777414_800.jpg",
        "https://cdn-images.farfetch-contents.com/19/90/96/96/19909696_52881384_800.jpg"
      ],
      "merchant_id": 13539,
      "stock_quantity": 2,
      "available_sizes": [
        {
          "size": "XS",
          "scale_id": 34061
        },
        {
          "size": "S",
          "scale_id": 34061
        }
      ],
      "is_pre_owned": false,
      "labels": [
        "Previous Season"
      ],
      "category_ids": [
        141258,
        135967,
        135979
      ],
      "uploaded_at": "2023-03-07T00:00:00Z"
    },
    {
      "id": 37448443,
      "url": "https://www.farfetch.com/de/shopping/women/gucci-rib-cotton-jersey-dress-with-web-item-37448443.aspx",
      "title": "rib cotton jersey dress with Web",
      "brand": {
        "id": 25354,
        "name": "Gucci"
      },
      "gender": "Woman",
      "price": {
        "amount": 890,
        "currency": "EUR"
      },
      "original_price": {
        "amount": 890,
        "currency": "EUR"
      },
      "discount_percent": 0,
      "price_type": "full_price",
      "images": [
        "https://cdn-images.farfetch-contents.com/37/44/84/43/37448443_70300879_800.jpg",
        "https://cdn-images.farfetch-contents.com/37/44/84/43/37448443_70191392_800.jpg"
      ],
      "merchant_id": 17144,
      "stock_quantity": 2,
      "available_sizes": [
        {
          "size": "XS",
          "scale_id": 34061
        },
        {
          "size": "M",
          "scale_id": 34061
        }
      ],
      "is_pre_owned": false,
      "category_ids": [
        141258,
        135967,
        135979
      ],
      "uploaded_at": "2026-07-20T09:00:00Z"
    },
    {
      "id": 21031208,
      "url": "https://www.farfetch.com/de/shopping/women/gucci-gg-supreme-sleeveless-minidress-item-21031208.aspx",
      "title": "GG Supreme sleeveless minidress",
      "brand": {
        "id": 25354,
        "name": "Gucci"
      },
      "gender": "Woman",
      "price": {
        "amount": 1040,
        "currency": "EUR"
      },
      "original_price": {
        "amount": 2600,
        "currency": "EUR"
      },
      "discount_percent": 60,
      "price_type": "sale",
      "images": [
        "https://cdn-images.farfetch-contents.com/21/03/12/08/21031208_59952754_800.jpg",
        "https://cdn-images.farfetch-contents.com/21/03/12/08/21031208_59952749_800.jpg",
        "https://cdn-images.farfetch-contents.com/21/03/12/08/21031208_59952769_800.jpg"
      ],
      "merchant_id": 13539,
      "stock_quantity": 1,
      "available_sizes": [
        {
          "size": "XS",
          "scale_id": 34061
        }
      ],
      "is_pre_owned": false,
      "labels": [
        "Previous Season"
      ],
      "category_ids": [
        141258,
        135967,
        135979
      ],
      "uploaded_at": "2023-08-07T00:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 40,
    "total_results": 14,
    "total_pages": 1,
    "has_more": false
  },
  "country": "DE",
  "currency": "EUR",
  "meta": {
    "endpoint_family": "search",
    "filtered_out": 0,
    "request_id": "req_4eb058d0cebf4cabaa00e96947be9dfd",
    "credits_charged": 1,
    "credits_remaining": 1916
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#idintegerurlurltitlestringbrandobjectgenderstringpriceobjectoriginal_priceobjectdiscount_percentintegerprice_typestringimagesstring[]merchant_idintegerstock_quantityintegeravailable_sizesobject[]is_pre_ownedbooleanlabelsstring[]category_idsnumber[]uploaded_atstring
119909696https://www.farfetch.com/de/shopping/women/gucci-polka-dot-one-shoulder-minidress-item-19909696.aspxpolka-dot one-shoulder minidress{2 fields}Woman{2 fields}{2 fields}60sale[3 items]135392[2 items]false[1 item][3 items]2023-03-07T00:00:00Z
237448443https://www.farfetch.com/de/shopping/women/gucci-rib-cotton-jersey-dress-with-web-item-37448443.aspxrib cotton jersey dress with Web{2 fields}Woman{2 fields}{2 fields}0full_price[2 items]171442[2 items]false—[3 items]2026-07-20T09:00:00Z
321031208https://www.farfetch.com/de/shopping/women/gucci-gg-supreme-sleeveless-minidress-item-21031208.aspxGG Supreme sleeveless minidress{2 fields}Woman{2 fields}{2 fields}60sale[3 items]135391[1 item]false[1 item][3 items]2023-08-07T00:00:00Z

Recorded from our API · 3 items shown · 17 datapoints per itemGET /v1/farfetch/search?country=DE&query=dress&designer[]=Gucci&gender=women&price_max=2000&sort=price_asc

17 datapoints

Identity

  • idinteger
  • titlestring
  • brandobject
  • merchant_idinteger
  • category_idsnumber[]

Contact

  • urlurl

Reputation

  • imagesstring[]

Price

  • priceobject
  • original_priceobject
  • discount_percentinteger
  • price_typestring

Other

  • genderstring
  • stock_quantityinteger
  • available_sizesobject[]
  • is_pre_ownedboolean
  • labelsstring[]
  • uploaded_atstring

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/farfetch/search?country=DE&query=dress&designer[]=Gucci&gender=women&price_max=2000&sort=price_asc" \
  -H "X-API-Key: $API_KEY"

Farfetch · 2 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/farfetch/product
none+4 optional
1 credit
GET/v1/farfetch/search
none+14 optional
1 credit

Overview

What you can get

The Farfetch API returns Farfetch product data as JSON through 2 endpoints. Both take an optional country (DE, US, GB, FR, IT, ES, NL, JP, CA, AU, CH, AE, SE or CN) and currency (EUR, USD, GBP, JPY, CAD, AUD, CHF, AED, SEK or CNY).

  • Search: search takes a query, with gender (women, men or unisex), price_min, price_max, sale_only, sort (ranking, newest, price_asc, price_desc or discount_desc), page and page_size. designer[], category[], size[] and color[] are repeatable.
  • Products: product takes an id or a url.

The recorded search for "dress" in DE with designer[]=Gucci, gender=women, price_max=2000 and sort=price_asc returns items, each with id, url, title, brand, price, original_price, discount_percent, price_type, images, merchant_id, stock_quantity, available_sizes, is_pre_owned and uploaded_at. It also returns pagination with total_results (14 in that recording) and has_more, plus the country and currency.

How a call works

Search a country: GET /v1/farfetch/search?country=DE&query=dress&designer[]=Gucci&gender=women&price_max=2000&sort=price_asc with your key in the X-API-Key header. Each result carries an id, which product takes. Every successful call costs 1 credit; failed calls cost nothing.

MarketplacesJSONRESTMCP

More marketplaces APIs

About YouadidasAliExpressAllegroAmazonASOSBilliger.debol.comChrono24CostcoCraigslistDBA

Use cases

Track a designer's prices and markdowns by country

Use the Farfetch API to track a designer's prices and markdowns by country

Compare the same product's price across countries and currencies

Use the Farfetch API to compare the same product's price across countries and currencies

Find the deepest discounts with `sort=discount_desc` and `sale_only`

Use the Farfetch API to find the deepest discounts with `sort=discount_desc` and `sale_only`

Watch new arrivals for a designer with `sort=newest`

Use the Farfetch API to watch new arrivals for a designer with `sort=newest`

FAQ

Questions

How much does the Farfetch API cost?

Each successful call costs one credit, and each search page is one call. New accounts get free credits to start, and credit packs bring the price down as you scale.

Can I get prices in another currency?

Yes. Pass `country` and `currency` to `search` or `product`.

Do I need a Farfetch account?

No. You call this Farfetch API with your Perceptlayer key in the `X-API-Key` header, with no Farfetch login.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Should I build a Farfetch scraper instead?

You can, but a Farfetch scraper is code you maintain: page changes break it, requests get blocked, and Farfetch's terms govern how you collect data. The Farfetch API gives you 2 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the Farfetch API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs