---
title: "Farfetch API: Search | Perceptlayer"
description: "Search from Farfetch as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/farfetch/search
---

[APIs](https://perceptlayer.com/apis) / [Farfetch](https://perceptlayer.com/apis/farfetch) / Search

# 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 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

[Run this endpoint in the playground](https://perceptlayer.com/apis/farfetch?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.