Farfetch Scraper

Scrapes Farfetch: prices (current and before discount), brand, sizes, colours, stock, images and every variant of each product, plus the category tree with the listing facets. Works with category, designer, sale, set, search and product URLs of any Farfetch storefront (/nl/, /uk/, /de/, /jp/, …) in the locale and currency of the given URL — or just type a search term, a category and/or a brand and no URL is needed. One dataset record per product or category.

Input

Field	Type	Default	Description
startUrls	array	—	Farfetch URLs of any storefront (see below). Optional when search, category or brand is given.
search	string	—	Search term as typed into the site's search box (gucci bag). The search URL is built for you.
category	string	—	Every product of a category: name (Mules, Sneakers), Parent > Name when the name repeats (Shoes > Boots), URL slug (mules-1), listing URL or id.
brand	string	—	Brand / designer: name (Gucci), slug or id. With category → that brand in that category.
department	women | men | kids	women	Department for search / category / brand.
storefront	string	nl	Storefront country code for search / category / brand (uk, de, us, jp, …): country and currency of prices.
sale	boolean	false	search / category / brand: discounted products only.
sortBy	string	ranking	search / category / brand order: ranking, newest, price_asc, price_desc, discount.
withCategoryProducts	boolean	false	For storefront / department URLs: besides the category records, collect every product of the department (each product once). false → category records only, one request per category.
withSizeFit	boolean	false	Fill variants[].extraInfo with fit notes and measurements.
withRecommends	boolean	false	Fetch up to 12 recommended products per product (recommendedProducts).
maxItems	integer ≥ 0	100 when empty	Limit of saved records (products + categories). Every record is charged, so this is also a cost cap. 0 → unlimited.
maxRequestsPerCrawl	integer ≥ 0	—	Legacy name of maxItems (tasks created before v2.1). Ignored when maxItems is set.
maxConcurrency	integer 1–100	5	Parallel requests. Lower → smaller risk of blocks.
proxy	object	Apify Proxy (datacenter)	Proxy configuration. With a proxy country, URLs without a storefront prefix (/shopping/...) are served in that country's storefront and currency.
browserImpersonation	string	safari_ios	Advanced: browser profile used for requests. Keep the default.

Supported startUrls

• Storefront — https://www.farfetch.com/, https://www.farfetch.com/jp/ → every category of the storefront (women, men, kids).
• Department — /shopping/women/, /shopping/men/, /shopping/kids/ → every category of the department.
• Listing with filters — /shopping/women/mules-1/items.aspx?designer=1168&colour=1 (always from page 1).
• Sale, designer, set (/sets/...aspx) and search listings.
• Product — any product page (...-item-<id>.aspx).

Country and currency come from the storefront subfolder in the URL (/uk/ → GB, GBP; /de/ → DE, EUR, …). The language is English, as the site serves it by default (/de/ pages come in en-GB too); ?lang=de etc. picks one of the storefront's languages.

Search, category and brand without a URL

Fill search, category and/or brand (any combination) and the scraper builds the listing itself: it collects all the products the site's own search or category page shows. Records get the equivalent site URL as crawlUrl.

{ "search": "gucci bag", "maxItems": 200 }
{ "category": "Sneakers", "brand": "Gucci", "department": "men", "sortBy": "newest" }
{ "category": "Boots", "sale": true, "storefront": "uk", "sortBy": "price_asc" }

Names are matched case-insensitively against the English category tree and the brand list of the department (Sneakers and Pants also find the British Trainers and Trousers). A name that matches nothing stops with an error that suggests close names; a category name that repeats picks the top-level one and says how to choose another. The site has no sale-only search page, so with search + sale the records' crawlUrl is the plain search page.

Example

{
  "startUrls": [
    { "url": "https://www.farfetch.com/nl/shopping/women/mules-1/items.aspx" },
    { "url": "https://www.farfetch.com/nl/shopping/women/jimmy-choo-cinch-small-bag-item-37439062.aspx" }
  ],
  "withCategoryProducts": false,
  "withSizeFit": true,
  "withRecommends": false,
  "maxItems": 500,
  "maxConcurrency": 5,
  "proxy": { "useApifyProxy": true }
}

A whole storefront has more than 1 200 categories. With maxItems: 0 and withCategoryProducts: true cap the spend with Max total charge in the run options.

Output

Each record is either a product (has source) or a category (has handle and productsCount). All prices are integers in cents: 115000 = €1,150.00.

Product record

{
  "source": {
    "id": "37439062",
    "crawlUrl": "https://www.farfetch.com/nl/shopping/women/mules-1/items.aspx",
    "canonicalUrl": "https://www.farfetch.com/nl/shopping/women/jimmy-choo-cinch-small-bag-item-37439062.aspx",
    "retailer": "farfetch",
    "language": "en-GB",
    "currency": "EUR",
    "bundleIds": [],
    "createdUTC": null,
    "updatedUTC": 1792749806217,
    "publishedUTC": null
  },
  "title": "Cinch small bag",
  "description": "Defined by a soft silhouette, the Cinch bag features a faceted drawstring closure. …",
  "details": {
    "short_desc": "Cinch small bag",
    "full_desc": "Defined by a soft silhouette, …",
    "highlights": ["shiny croc-embossed leather", "drawstring closure", "antique gold-tone hardware"],
    "composition": [{ "name": "Calf Leather", "percentage": 100, "part": "Outer" }],
    "care": {},
    "farfetchID": "37439062",
    "brandStyleID": "J000187429",
    "madeIn": { "origin": "Made in Italy", "disclaimers": null }
  },
  "brand": "Jimmy Choo",
  "categories": ["Women", "Bags", "Shoulder Bags"],
  "tags": [],
  "medias": [
    { "type": "Image", "url": "https://cdn-images.farfetch-contents.com/37/43/90/62/37439062_77000852_1000.jpg?ov=true",
      "alt": "Jimmy Choo Cinch small bag", "index": 0, "width": 1000, "height": null, "variantIds": [] }
  ],
  "variants": [
    {
      "id": "37439062-1", "title": "OS", "sku": "J000187429", "options": ["brown", "1"], "label": null,
      "price": { "current": 103700, "currentFormatted": "1.037 €", "previous": null, "original": 0,
                 "stockStatus": "InStock", "stockCount": 7 },
      "medias": [], "extraInfo": { "fit": null, "measurements": null }
    }
  ],
  "options": [
    { "type": "Colour", "values": [{ "id": "brown", "name": "Brown", "icon": null }] },
    { "type": "Size", "values": [{ "id": "1", "name": "OS", "icon": null }] }
  ],
  "price": { "current": 103700, "currentFormatted": "1.037 €", "previous": null, "original": 0,
             "stockStatus": "InStock", "stockCount": 7 },
  "stats": { "rating": null, "reviewCount": null, "lovesCount": null },
  "extraInfo": { "label": null, "color": "1C1198 - SAMBUCOGOLD", "mainColor": "Brown", "condition": "New" },
  "subProducts": [],
  "recommendedProducts": []
}

Field	Notes
source.updatedUTC	Farfetch's product version timestamp (ms). createdUTC / publishedUTC are not published → null.
price.current / previous / original	Cents. previous = price before the discount (null without discount), original = the same, 0 when the product is at full price.
price.stockStatus	InStock (> 5 pieces), LowInStock (1–5), OutOfStock. stockCount = pieces of the priced size across all sellers.
variants[]	One per size, in-stock sizes first. Each size is offered by one or more sellers; the cheapest available offer sets the price, stockCount sums all sellers. A size nobody offers gets the product price with OutOfStock. extraInfo is filled only with withSizeFit (fit: [{type, description}], measurements: [{type, name, imperial, metric}], null when Farfetch has none).
options[]	Colour (Farfetch products are single-colour) and Size. variants[].options = [colourId, sizeId].
medias[]	Product images (1000 px wide); height is not published.
stats	Farfetch publishes no ratings → all null.
recommendedProducts[]	Only with withRecommends: {id, url, raw} where raw is the product in Farfetch's catalog-item format (price, productPrice, brand, images, sizes, tags, categories…).

Category record

{
  "id": "198938",
  "handle": "women/shoes/mules",
  "productsCount": 2127,
  "publishedUTC": null,
  "updatedUTC": null,
  "retailer": "farfetch",
  "url": "https://www.farfetch.com/nl/shopping/women/mules-1/items.aspx",
  "country": "NL",
  "language": "en-GB",
  "currency": "EUR",
  "department": "Women",
  "parentId": "136301",
  "paths": [["Women", "Shoes", "Mules"]],
  "description": "",
  "facets": [
    { "id": "brands", "name": "Brand", "type": "brands",
      "values": [{ "id": "1168", "name": "Gucci", "count": 87 }] },
    { "id": "attributes:11006", "name": "Heel Height", "type": "attributes",
      "values": [{ "id": "19500034", "name": "Flat" }] }
  ]
}

handle is built from the English category names from the department root, so it is identical on every storefront; paths and department are in the storefront's language. productsCount counts all products of the category including the ones on sale. facets[] are the listing filters: categories, brands, colors, sizes, price, discount, promotions, delivery, seasons, shippingLocations and one attributes:<id> facet per attribute group; values[].count is given for categories, brands and colours.

Tips

• Use URLs with a storefront prefix (https://www.farfetch.com/nl/..., /uk/...): they are the fastest and most reliable. Sets (/sets/...), URLs without a prefix and listings with uncommon filters take a slower path that may need a residential proxy.
• The default Apify Proxy works for most runs; switch the proxy to residential if you see blocked requests in the log.
• Products are deduplicated within a run, and maxItems stops the run once that many records are saved.

Limits

• Farfetch publishes no ratings, reviews or "loves" counts, no creation / publication dates and no image dimensions; the corresponding fields are null.
• Product descriptions on Farfetch are short; description falls back to the title when none exists.
• The China storefront (farfetch.cn) and logged-in features (wishlist, private sales) are not supported.
• The storefront language defaults to English (as on the site); add ?lang=de etc. to a start URL for another one.