Farfetch: Search

Search from Farfetch as JSON. 1 credit per successful call.

GET /v1/farfetch/search

Parameters

Send parameters in the query string.

Parameter	Type	Required	Allowed values
`country`	string	Optional	DE, US, GB, FR, IT, ES, NL, JP, CA, AU, CH, AE, SE, CN
`currency`	string	Optional	EUR, USD, GBP, JPY, CAD, AUD, CHF, AED, SEK, CNY
`query`	string	Optional	Up to 100 characters
`designer[]`	list of string	Optional	Up to 80 characters
`category[]`	list of string	Optional	Up to 80 characters
`gender`	string	Optional	women, men, unisex
`size[]`	list of string	Optional	Up to 20 characters
`color[]`	list of string	Optional	Up to 40 characters
`price_min`	integer	Optional	Any
`price_max`	integer	Optional	Any
`sale_only`	boolean	Optional	Any
`sort`	string	Optional	ranking, newest, price_asc, price_desc, discount_desc
`page`	integer	Optional	Any
`page_size`	integer	Optional	Any

Example request

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.

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.