--- title: "Farfetch API: JSON data, 2 endpoints, 1 credit per call" description: "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." url: https://perceptlayer.com/apis/farfetch --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / Farfetch 1 credit per call 2 endpoints 17 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-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. | # | id integer | url url | title string | brand object | gender string | price object | original\_price object | discount\_percent integer | price\_type string | images string\[\] | merchant\_id integer | stock\_quantity integer | available\_sizes object\[\] | is\_pre\_owned boolean | labels string\[\] | category\_ids number\[\] | uploaded\_at string | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 19909696 | https://www.farfetch.com/de/shopping/women/gucci-polka-dot-one-shoulder-minidress-item-19909696.aspx | polka-dot one-shoulder minidress | {2 fields} | Woman | {2 fields} | {2 fields} | 60 | sale | \[3 items\] | 13539 | 2 | \[2 items\] | false | \[1 item\] | \[3 items\] | 2023-03-07T00:00:00Z | | 2 | 37448443 | https://www.farfetch.com/de/shopping/women/gucci-rib-cotton-jersey-dress-with-web-item-37448443.aspx | rib cotton jersey dress with Web | {2 fields} | Woman | {2 fields} | {2 fields} | 0 | full\_price | \[2 items\] | 17144 | 2 | \[2 items\] | false | — | \[3 items\] | 2026-07-20T09:00:00Z | | 3 | 21031208 | https://www.farfetch.com/de/shopping/women/gucci-gg-supreme-sleeveless-minidress-item-21031208.aspx | GG Supreme sleeveless minidress | {2 fields} | Woman | {2 fields} | {2 fields} | 60 | sale | \[3 items\] | 13539 | 1 | \[1 item\] | false | \[1 item\] | \[3 items\] | 2023-08-07T00:00:00Z | Recorded from our API · 3 items shown · 17 datapoints per item GET /v1/farfetch/search?country=DE&query=dress&designer\[\]=Gucci&gender=women&price\_max=2000&sort=price\_asc 17 datapoints ### Identity - id integer - title string - brand object - merchant\_id integer - category\_ids number\[\] ### Contact - url url ### Reputation - images string\[\] ### Price - price object - original\_price object - discount\_percent integer - price\_type string ### Other - gender string - stock\_quantity integer - available\_sizes object\[\] - is\_pre\_owned boolean - labels string\[\] - uploaded\_at string Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/farfetch/product`](https://perceptlayer.com/apis/farfetch/product) | none +4 optional | 1 credit | | [GET `/v1/farfetch/search`](https://perceptlayer.com/apis/farfetch/search) | none +14 optional | 1 credit | Overview ## About the Farfetch API ## 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. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)