{
  "data": {
    "id": "iCRcK5JGIZAx78Tsn",
    "actId": "pvyZfFA3yzYwp4gwc",
    "userId": "IYgBDiXtHOijAaUel",
    "startedAt": "2026-11-20T15:04:46.829Z",
    "finishedAt": "2026-11-20T15:04:52.243Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 5296,
      "runTimeSecs": 5.296,
      "computeUnits": 0.005884444444444445,
      "imageSizeBytes": 362856448
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "QYo53EZkJk0prePWY",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Farfetch Scraper Input\",\n  \"description\": \"Search Farfetch luxury fashion by keyword, brand, category, gender, or sale items across regional storefronts.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"What to browse on Farfetch.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"search\",\n        \"searchByBrand\",\n        \"category\",\n        \"newIn\",\n        \"saleItems\",\n        \"listingUrls\",\n        \"productDetails\"\n      ],\n      \"enumTitles\": [\n        \"Search by keyword\",\n        \"Browse by brand\",\n        \"Browse a category\",\n        \"New arrivals\",\n        \"Sale items\",\n        \"Scrape listing URLs\",\n        \"Get product details by URLs\"\n      ],\n      \"default\": \"search\",\n      \"prefill\": \"search\"\n    },\n    \"locale\": {\n      \"title\": \"Storefront / currency\",\n      \"type\": \"string\",\n      \"description\": \"Regional Farfetch storefront. Prices and availability are local to the selected market.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"nz\",\n        \"uk\",\n        \"fr\",\n        \"de\",\n        \"it\",\n        \"es\",\n        \"ie\",\n        \"hk\",\n        \"mo\",\n        \"cn\",\n        \"sg\",\n        \"jp\",\n        \"kr\",\n        \"au\",\n        \"ca\",\n        \"ae\",\n        \"tw\"\n      ],\n      \"enumTitles\": [\n        \"New Zealand (USD)\",\n        \"United Kingdom (GBP)\",\n        \"France (EUR)\",\n        \"Germany (EUR)\",\n        \"Italy (EUR)\",\n        \"Spain (EUR)\",\n        \"Ireland (EUR)\",\n        \"Hong Kong (HKD)\",\n        \"Macau (HKD)\",\n        \"Mainland China (CNY)\",\n        \"Singapore (SGD)\",\n        \"Japan (JPY)\",\n        \"South Korea (KRW)\",\n        \"Australia (AUD)\",\n        \"Canada (CAD)\",\n        \"United Arab Emirates (AED)\",\n        \"Taiwan (TWD)\"\n      ],\n      \"default\": \"nz\",\n      \"prefill\": \"nz\"\n    },\n    \"keyword\": {\n      \"title\": \"Search keyword\",\n      \"type\": \"string\",\n      \"description\": \"Product keyword to search for (mode=search), e.g. 'Gucci bag', 'Prada shoes'.\",\n      \"editor\": \"textfield\",\n      \"default\": \"Gucci bag\",\n      \"prefill\": \"Gucci bag\"\n    },\n    \"brand\": {\n      \"title\": \"Brand (mode=searchByBrand)\",\n      \"type\": \"string\",\n      \"description\": \"Brand name or slug to browse (e.g. 'gucci', 'prada', 'balenciaga').\",\n      \"editor\": \"textfield\"\n    },\n    \"gender\": {\n      \"title\": \"Gender\",\n      \"type\": \"string\",\n      \"description\": \"Filter by gender for search, brand, new-arrivals and sale modes. Category mode follows the department in the selected category. When omitted, listings use the women's storefront.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"women\",\n        \"men\",\n        \"kids\"\n      ],\n      \"enumTitles\": [\n        \"All genders\",\n        \"Women\",\n        \"Men\",\n        \"Kids\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"category\": {\n      \"title\": \"Category (mode=category)\",\n      \"type\": \"string\",\n      \"description\": \"Farfetch department and category to browse. Each option is a live catalog path, e.g. 'Women - Bags' or 'Men - Shoes'.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"women/clothing-1\",\n        \"women/shoes-1\",\n        \"women/bags-purses-1\",\n        \"women/accessories-all-1\",\n        \"women/jewellery-1\",\n        \"women/watches-1\",\n        \"women/pre-owned-1\",\n        \"women/activewear-1\",\n        \"women/lingerie-hosiery-1\",\n        \"women/lifestyle-1\",\n        \"women/fine-jewellery-6\",\n        \"women/demi-fine-jewellery-1\",\n        \"men/clothing-2\",\n        \"men/shoes-2\",\n        \"men/bags-purses-2\",\n        \"men/accessories-all-2\",\n        \"men/jewellery-2\",\n        \"men/watches-4\",\n        \"men/pre-owned-2\",\n        \"men/activewear-2\",\n        \"men/underwear-socks-2\",\n        \"men/lifestyle-2\",\n        \"kids/boys-clothing-3\",\n        \"kids/boys-shoes-3\",\n        \"kids/boys-accessories-3\",\n        \"kids/girls-clothing-4\",\n        \"kids/girls-shoes-4\",\n        \"kids/girls-accessories-1\",\n        \"kids/baby-boy-clothing-5\",\n        \"kids/baby-boy-shoes-5\",\n        \"kids/baby-boy-accessories-5\",\n        \"kids/baby-girl-clothing-6\",\n        \"kids/baby-girl-shoes-6\",\n        \"kids/baby-girl-accessories-6\",\n        \"kids/teen-boy-clothing-8\",\n        \"kids/teen-boy-accessories-8\",\n        \"kids/teen-boy-shoes-1\",\n        \"kids/teen-girl-clothing-7\",\n        \"kids/teen-girl-accessories-7\",\n        \"kids/teen-girl-shoes-1\",\n        \"kids/baby-nursery-5\"\n      ],\n      \"enumTitles\": [\n        \"Women - Clothing\",\n        \"Women - Shoes\",\n        \"Women - Bags\",\n        \"Women - Accessories\",\n        \"Women - Jewellery\",\n        \"Women - Watches\",\n        \"Women - Pre-Owned\",\n        \"Women - Activewear\",\n        \"Women - Lingerie & Nightwear\",\n        \"Women - Homeware\",\n        \"Women - Fine Jewellery\",\n        \"Women - Demi-Fine Jewellery\",\n        \"Men - Clothing\",\n        \"Men - Shoes\",\n        \"Men - Bags\",\n        \"Men - Accessories\",\n        \"Men - Jewellery\",\n        \"Men - Watches\",\n        \"Men - Pre-Owned\",\n        \"Men - Activewear\",\n        \"Men - Underwear & Socks\",\n        \"Men - Homeware\",\n        \"Kids - Boys Clothing\",\n        \"Kids - Boys Shoes\",\n        \"Kids - Boys Accessories\",\n        \"Kids - Girls Clothing\",\n        \"Kids - Girls Shoes\",\n        \"Kids - Girls Accessories\",\n        \"Kids - Baby Boy Clothing\",\n        \"Kids - Baby Boy Shoes\",\n        \"Kids - Baby Boy Accessories\",\n        \"Kids - Baby Girl Clothing\",\n        \"Kids - Baby Girl Shoes\",\n        \"Kids - Baby Girl Accessories\",\n        \"Kids - Teen Boy Clothing\",\n        \"Kids - Teen Boy Accessories\",\n        \"Kids - Teen Boy Shoes\",\n        \"Kids - Teen Girl Clothing\",\n        \"Kids - Teen Girl Accessories\",\n        \"Kids - Teen Girl Shoes\",\n        \"Kids - Baby Nursery\"\n      ],\n      \"default\": \"women/bags-purses-1\"\n    },\n    \"sortBy\": {\n      \"title\": \"Sort order\",\n      \"type\": \"string\",\n      \"description\": \"Order of listing results. Applies to search, brand, category, new-arrivals and sale modes.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"recommended\",\n        \"newest\",\n        \"priceHighToLow\",\n        \"priceLowToHigh\",\n        \"saleHighToLow\"\n      ],\n      \"enumTitles\": [\n        \"Recommended\",\n        \"Newest first\",\n        \"Price: high to low\",\n        \"Price: low to high\",\n        \"Biggest discount first\"\n      ],\n      \"default\": \"recommended\"\n    },\n    \"colors\": {\n      \"title\": \"Colors\",\n      \"type\": \"array\",\n      \"description\": \"Only include products in these colors. Leave empty for every color.\",\n      \"editor\": \"select\",\n      \"uniqueItems\": true,\n      \"items\": {\n        \"type\": \"string\",\n        \"enum\": [\n          \"Black\",\n          \"White\",\n          \"Grey\",\n          \"Neutrals\",\n          \"Brown\",\n          \"Green\",\n          \"Blue\",\n          \"Red\",\n          \"Pink\",\n          \"Yellow\",\n          \"Metallic\",\n          \"Multicolour\",\n          \"Gold\",\n          \"Silver\",\n          \"Purple\",\n          \"Orange\"\n        ]\n      },\n      \"default\": []\n    },\n    \"priceMin\": {\n      \"title\": \"Minimum price\",\n      \"type\": \"integer\",\n      \"description\": \"Lowest price to include, in the selected storefront's currency. Leave empty for no minimum.\",\n      \"minimum\": 0,\n      \"maximum\": 1000000\n    },\n    \"priceMax\": {\n      \"title\": \"Maximum price\",\n      \"type\": \"integer\",\n      \"description\": \"Highest price to include, in the selected storefront's currency. Leave empty for no maximum.\",\n      \"minimum\": 0,\n      \"maximum\": 1000000\n    },\n    \"discountRange\": {\n      \"title\": \"Discount\",\n      \"type\": \"string\",\n      \"description\": \"Only include products in this Farfetch sale-discount band. The matching value per product is saleDiscountPercent. Applies to search, brand, category, new-arrivals and sale modes.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"none\",\n        \"upTo30\",\n        \"30to50\",\n        \"50to60\",\n        \"60plus\"\n      ],\n      \"enumTitles\": [\n        \"Any discount\",\n        \"No discount\",\n        \"Up to 30% off\",\n        \"30% - 50% off\",\n        \"50% - 60% off\",\n        \"60%+ off\"\n      ],\n      \"default\": \"\"\n    },\n    \"listingUrls\": {\n      \"title\": \"Listing URLs (mode=listingUrls)\",\n      \"type\": \"array\",\n      \"description\": \"Farfetch category, brand, sale, set or search listing URLs. Both farfetch.com and farfetch.cn URLs are accepted; every listing starts at page 1 with 180 products per page.\",\n      \"editor\": \"stringList\",\n      \"default\": []\n    },\n    \"productUrls\": {\n      \"title\": \"Product URLs (mode=productDetails)\",\n      \"type\": \"array\",\n      \"description\": \"Farfetch product page URLs to scrape. Both farfetch.com and farfetch.cn URLs are accepted and converted to the selected storefront.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum number of products to return (1-2500).\",\n      \"minimum\": 1,\n      \"maximum\": 2500,\n      \"default\": 20,\n      \"prefill\": 3\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# Farfetch Luxury Fashion Price & Discount Extractor\n\nFarfetch brings together luxury fashion from boutiques and designer brands around the world. This actor searches Farfetch by keyword, browses a brand or a full category, lists new arrivals and sale items, or looks up specific product URLs. Every product comes back as a structured record with local pricing, discount, sizes, color, stock, category, images and product details.\n\n## What this actor does\n\n- Searches Farfetch products by free-text keyword\n- Browses a designer's catalogue\n- Browses live women's, men's and kids' categories — clothing, shoes, bags, accessories, jewellery, watches, pre-owned, activewear, lingerie and homeware\n- Lists new arrivals and currently discounted sale items, optionally filtered by gender\n- Filters listings by color, price band, discount band and sort order\n- Scrapes any Farfetch listing URL, including sale-category and combined-filter pages\n- Fetches full product details for a list of Farfetch product URLs, including the seller/boutique and brand style code\n- Supports 17 regional storefronts with local currencies, including USD, GBP, EUR, HKD, CNY, SGD, JPY and more\n- Empty fields are omitted — a field only appears when Farfetch published that data for the product\n\n## Data source\n\nFarfetch's global `farfetch.com` host blocks automated HTTP access. This actor uses Farfetch's publicly accessible regional storefronts on `farfetch.cn`, which expose the same global product IDs through server-rendered product pages — no login, account or cookies required. Product pages also embed the seller (boutique) and brand style code in their hydration state, so those fields are read without extra requests.\n\nPrices, discounts and availability are local to the selected storefront. Use the `locale` input to choose the market and currency. For USD, use `nz`; for GBP, `uk`; for EUR, choose `fr`, `de`, `it`, `es` or `ie`.\n\n## Output per product\n\n- `productId` — Farfetch's internal product ID\n- `brand` — brand/designer label on the product\n- `title` — product name\n- `price` — current (final/discounted) price in the selected storefront's currency\n- `originalPrice` — pre-discount price, when the item is on sale\n- `discountPercent` — total discount percentage against `originalPrice`, when on sale\n- `discountAmount` — absolute amount saved, when on sale\n- `saleDiscountPercent` — Farfetch's sale-stage discount percentage shown on sale listings; the `discountRange` filter follows this value\n- `currency` — currency code (USD, GBP, EUR, HKD, CNY, …)\n- `locale` — storefront used for the record\n- `color` — product color (product-details mode)\n- `condition` — `new` or `used`, from Farfetch's product condition (product-details mode)\n- `category` — deepest category in the product breadcrumb, e.g. `Shoulder Bags` (product-details mode)\n- `categories` — full category breadcrumb below the brand, e.g. `[\"Bags\", \"Shoulder Bags\"]` (product-details mode)\n- `gender` — women, men or kids, when known\n- `imageUrl` — primary product image URL\n- `images` — all product image URLs\n- `productUrl` — direct link to the product on the selected storefront\n- `sizes` — available size labels, when listed\n- `variants` — per-size records with `sku`, `size`, `price`, `originalPrice`, `discountPercent`, `discountAmount`, `currency`, `availability`, `returnDays` and `returnFees` (product-details mode)\n- `description` — product description (product-details mode)\n- `boutique` — seller/boutique name published on the product page (product-details mode)\n- `styleCode` — brand style ID published on the product page (product-details mode)\n- `availability` — stock status such as `InStock`\n- `stockQuantity` — units Farfetch reports in stock for the listing item (listing modes)\n- `position` — rank of the product in the returned result order (listing modes)\n- `returnDays` — return window in days, when Farfetch publishes it\n- `returnFees` — return-fee policy, such as `FreeReturn`, when published\n- `designer` — designer name, when distinct from `brand`\n- `material` — product material/composition, when listed\n- `mode` — which scraping mode produced this record\n- `scrapedAt` — ISO timestamp when the record was collected\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search`, `searchByBrand`, `category`, `newIn`, `saleItems`, `listingUrls`, or `productDetails` |\n| `locale` | string | `nz` | Storefront and currency: `nz` (USD), `uk` (GBP), `fr`/`de`/`it`/`es`/`ie` (EUR), `hk`/`mo` (HKD), `cn` (CNY), `sg` (SGD), `jp` (JPY), `kr` (KRW), `au` (AUD), `ca` (CAD), `ae` (AED), `tw` (TWD) |\n| `keyword` | string | `Gucci bag` | Search keyword, used in `search` mode |\n| `brand` | string | – | Brand name or slug (e.g. `gucci`, `prada`), used in `searchByBrand` mode |\n| `gender` | string | – (women for listings) | `women`, `men`, or `kids` for search, brand, new-arrivals and sale modes |\n| `category` | string | `women/bags-purses-1` | Live category path for `category` mode, e.g. `women/bags-purses-1`, `men/shoes-2`, `kids/girls-clothing-4` |\n| `sortBy` | string | `recommended` | `recommended`, `newest`, `priceHighToLow`, `priceLowToHigh`, or `saleHighToLow` |\n| `colors` | array | – (all colors) | Color filter: `Black`, `White`, `Grey`, `Neutrals`, `Brown`, `Green`, `Blue`, `Red`, `Pink`, `Yellow`, `Metallic`, `Multicolour`, `Gold`, `Silver`, `Purple`, `Orange` |\n| `priceMin` | integer | – | Lowest price to include, in the storefront currency |\n| `priceMax` | integer | – | Highest price to include, in the storefront currency |\n| `discountRange` | string | – (any) | Farfetch sale-discount band: `none`, `upTo30`, `30to50`, `50to60`, or `60plus`. The matching value per product is `saleDiscountPercent`. |\n| `listingUrls` | array | `[]` | Farfetch category, brand, sale, set or search listing URLs, used in `listingUrls` mode. Both `.com` and `.cn` URLs are accepted. |\n| `productUrls` | array | `[]` | Farfetch product page URLs to scrape directly, used in `productDetails` mode. Both `.com` and `.cn` URLs are accepted. |\n| `maxItems` | integer | `20` | Maximum number of products to return (1–2500) |\n\n`category` mode follows the department in the selected category path, so `gender` is not combined with it. The other listing modes use `gender`; when it is empty they use the women's storefront.\n\n### Example: keyword search in USD\n\n```json\n{\n  \"mode\": \"search\",\n  \"keyword\": \"Prada shoes\",\n  \"locale\": \"nz\",\n  \"maxItems\": 30\n}\n```\n\n### Example: women's bags under 1,500 USD, cheapest first\n\n```json\n{\n  \"mode\": \"category\",\n  \"category\": \"women/bags-purses-1\",\n  \"locale\": \"nz\",\n  \"priceMax\": 1500,\n  \"sortBy\": \"priceLowToHigh\",\n  \"maxItems\": 50\n}\n```\n\n### Example: black or brown men's shoes on sale\n\n```json\n{\n  \"mode\": \"category\",\n  \"category\": \"men/shoes-2\",\n  \"locale\": \"uk\",\n  \"colors\": [\"Black\", \"Brown\"],\n  \"discountRange\": \"30to50\",\n  \"sortBy\": \"saleHighToLow\",\n  \"maxItems\": 40\n}\n```\n\n### Example: everything from one designer, women's only, GBP\n\n```json\n{\n  \"mode\": \"searchByBrand\",\n  \"brand\": \"balenciaga\",\n  \"gender\": \"women\",\n  \"locale\": \"uk\",\n  \"maxItems\": 50\n}\n```\n\n### Example: new arrivals in EUR\n\n```json\n{\n  \"mode\": \"newIn\",\n  \"gender\": \"women\",\n  \"locale\": \"fr\",\n  \"sortBy\": \"newest\",\n  \"maxItems\": 40\n}\n```\n\n### Example: scrape a filtered listing URL\n\n```json\n{\n  \"mode\": \"listingUrls\",\n  \"listingUrls\": [\n    \"https://www.farfetch.com/uk/shopping/women/sale/bags-purses-1/items.aspx?sort=5&colour=1&price=100-2000\"\n  ],\n  \"locale\": \"uk\",\n  \"maxItems\": 60\n}\n```\n\n### Example: look up specific products\n\n```json\n{\n  \"mode\": \"productDetails\",\n  \"locale\": \"nz\",\n  \"productUrls\": [\n    \"https://www.farfetch.com/shopping/women/gucci-gg-marmont-shoulder-bag-item-12345678.aspx\"\n  ]\n}\n```\n\n## Use cases\n\n- **Price monitoring** — track a designer's catalog or a whole category for price changes and new discounts in a chosen market\n- **Sale tracking** — pull sale items or discount bands regularly to catch markdowns as they appear\n- **Category research** — compare pricing and stock across women's, men's and kids' categories in different markets\n- **Trend forecasting** — scan new arrivals by gender to see what's launching across brands\n- **Catalog enrichment** — feed product URLs through `productDetails` to backfill price, sizes, color, condition, category and material data\n\n## FAQ\n\n**Do I need a Farfetch account or cookies?** No. Only publicly available product listings are read; no login, account or cookies are required.\n\n**Which market and currency should I use?** Use the `locale` that matches your target market. `nz` returns USD, `uk` returns GBP, `fr`/`de`/`it`/`es`/`ie` return EUR, and the other options return their local currencies. Farfetch prices are market-local, so the same product can cost different amounts in different storefronts.\n\n**Why does a product have no `originalPrice` or `discountPercent`?** Those fields only appear when the item is actually marked down; full-price items simply don't carry a discount.\n\n**What do `category` and `categories` mean?** Farfetch groups products in a breadcrumb below the brand. `categories` keeps the full trail and `category` is the deepest one, so a bag can come back as `[\"Bags\", \"Shoulder Bags\"]` and `Shoulder Bags`.\n\n**What is `condition`?** Farfetch marks new products as `new` and pre-owned products as `used`. Pre-owned listings often also have a Pre-Owned category in the breadcrumb.\n\n**Can I filter by size?** Size filtering is not exposed as an input. Farfetch's listing URL accepts only opaque internal numeric size IDs; letter sizes return a server error and the same ID means different labels on different size scales. Sizes are reported per product in `sizes` and per variant in `variants`, so filter the dataset on those fields after the run.\n\n**Can I combine filters?** Yes — category, brand or search mode can be combined with `gender`, `sortBy`, `colors`, `priceMin`, `priceMax` and `discountRange` in one run.\n\n**How many products can one run return?** Up to `maxItems`, capped at 2500. Listings return up to 180 products per page and paginate until the items run out; the source has no fixed page ceiling. For more than 2500, run separate categories, brands, price bands or discount bands and combine the datasets — deduplicate on `productId`.\n\n**Do I get the boutique and brand style code?** Yes, in `productDetails` mode: `boutique` is the seller name and `styleCode` is the brand style ID. Farfetch-owned products do not publish a boutique name, so that field is omitted for those records.\n\n**Why do some category URLs return no products?** Farfetch uses different category paths in different markets. Use the `category` dropdown, which contains only verified live paths, or search by keyword or brand.\n\n**Does Farfetch publish product ratings or reviews?** No. The regional product pages carry no per-product rating, review count or review text; the \"4.7/5 stars\" copy is Farfetch's site-wide marketing, not a product rating. Those fields are therefore not emitted.\n\n**Are prices the same as farfetch.com US?** No. The global `farfetch.com` host blocks automated access, so this actor uses Farfetch's regional storefronts. Prices and availability are local to the selected storefront and should be treated as market-specific.\n\n**Is this affiliated with Farfetch?** No. This is an independent, third-party actor that reads Farfetch's publicly available product pages; it is not operated by or affiliated with Farfetch.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "farfetch-luxury-fashion-price-and-discount",
      "title": "Farfetch Luxury Fashion Price & Discount Extractor",
      "description": "Browse Farfetch luxury fashion by keyword, brand, category, gender, new arrivals or sale items across regional storefronts to get local price, original price, discount, sizes, colors, stock and product details.",
      "version": "1.2",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# Farfetch Luxury Fashion Price & Discount Extractor\n\nFarfetch brings together luxury fashion from boutiques and designer brands around the world. This actor searches Farfetch by keyword, browses a brand or a full category, lists new arrivals and sale items, or looks up specific product URLs. Every product comes back as a structured record with local pricing, discount, sizes, color, stock, category, images and product details.\n\n## What this actor does\n\n- Searches Farfetch products by free-text keyword\n- Browses a designer's catalogue\n- Browses live women's, men's and kids' categories — clothing, shoes, bags, accessories, jewellery, watches, pre-owned, activewear, lingerie and homeware\n- Lists new arrivals and currently discounted sale items, optionally filtered by gender\n- Filters listings by color, price band, discount band and sort order\n- Scrapes any Farfetch listing URL, including sale-category and combined-filter pages\n- Fetches full product details for a list of Farfetch product URLs, including the seller/boutique and brand style code\n- Supports 17 regional storefronts with local currencies, including USD, GBP, EUR, HKD, CNY, SGD, JPY and more\n- Empty fields are omitted — a field only appears when Farfetch published that data for the product\n\n## Data source\n\nFarfetch's global `farfetch.com` host blocks automated HTTP access. This actor uses Farfetch's publicly accessible regional storefronts on `farfetch.cn`, which expose the same global product IDs through server-rendered product pages — no login, account or cookies required. Product pages also embed the seller (boutique) and brand style code in their hydration state, so those fields are read without extra requests.\n\nPrices, discounts and availability are local to the selected storefront. Use the `locale` input to choose the market and currency. For USD, use `nz`; for GBP, `uk`; for EUR, choose `fr`, `de`, `it`, `es` or `ie`.\n\n## Output per product\n\n- `productId` — Farfetch's internal product ID\n- `brand` — brand/designer label on the product\n- `title` — product name\n- `price` — current (final/discounted) price in the selected storefront's currency\n- `originalPrice` — pre-discount price, when the item is on sale\n- `discountPercent` — total discount percentage against `originalPrice`, when on sale\n- `discountAmount` — absolute amount saved, when on sale\n- `saleDiscountPercent` — Farfetch's sale-stage discount percentage shown on sale listings; the `discountRange` filter follows this value\n- `currency` — currency code (USD, GBP, EUR, HKD, CNY, …)\n- `locale` — storefront used for the record\n- `color` — product color (product-details mode)\n- `condition` — `new` or `used`, from Farfetch's product condition (product-details mode)\n- `category` — deepest category in the product breadcrumb, e.g. `Shoulder Bags` (product-details mode)\n- `categories` — full category breadcrumb below the brand, e.g. `[\"Bags\", \"Shoulder Bags\"]` (product-details mode)\n- `gender` — women, men or kids, when known\n- `imageUrl` — primary product image URL\n- `images` — all product image URLs\n- `productUrl` — direct link to the product on the selected storefront\n- `sizes` — available size labels, when listed\n- `variants` — per-size records with `sku`, `size`, `price`, `originalPrice`, `discountPercent`, `discountAmount`, `currency`, `availability`, `returnDays` and `returnFees` (product-details mode)\n- `description` — product description (product-details mode)\n- `boutique` — seller/boutique name published on the product page (product-details mode)\n- `styleCode` — brand style ID published on the product page (product-details mode)\n- `availability` — stock status such as `InStock`\n- `stockQuantity` — units Farfetch reports in stock for the listing item (listing modes)\n- `position` — rank of the product in the returned result order (listing modes)\n- `returnDays` — return window in days, when Farfetch publishes it\n- `returnFees` — return-fee policy, such as `FreeReturn`, when published\n- `designer` — designer name, when distinct from `brand`\n- `material` — product material/composition, when listed\n- `mode` — which scraping mode produced this record\n- `scrapedAt` — ISO timestamp when the record was collected\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search`, `searchByBrand`, `category`, `newIn`, `saleItems`, `listingUrls`, or `productDetails` |\n| `locale` | string | `nz` | Storefront and currency: `nz` (USD), `uk` (GBP), `fr`/`de`/`it`/`es`/`ie` (EUR), `hk`/`mo` (HKD), `cn` (CNY), `sg` (SGD), `jp` (JPY), `kr` (KRW), `au` (AUD), `ca` (CAD), `ae` (AED), `tw` (TWD) |\n| `keyword` | string | `Gucci bag` | Search keyword, used in `search` mode |\n| `brand` | string | – | Brand name or slug (e.g. `gucci`, `prada`), used in `searchByBrand` mode |\n| `gender` | string | – (women for listings) | `women`, `men`, or `kids` for search, brand, new-arrivals and sale modes |\n| `category` | string | `women/bags-purses-1` | Live category path for `category` mode, e.g. `women/bags-purses-1`, `men/shoes-2`, `kids/girls-clothing-4` |\n| `sortBy` | string | `recommended` | `recommended`, `newest`, `priceHighToLow`, `priceLowToHigh`, or `saleHighToLow` |\n| `colors` | array | – (all colors) | Color filter: `Black`, `White`, `Grey`, `Neutrals`, `Brown`, `Green`, `Blue`, `Red`, `Pink`, `Yellow`, `Metallic`, `Multicolour`, `Gold`, `Silver`, `Purple`, `Orange` |\n| `priceMin` | integer | – | Lowest price to include, in the storefront currency |\n| `priceMax` | integer | – | Highest price to include, in the storefront currency |\n| `discountRange` | string | – (any) | Farfetch sale-discount band: `none`, `upTo30`, `30to50`, `50to60`, or `60plus`. The matching value per product is `saleDiscountPercent`. |\n| `listingUrls` | array | `[]` | Farfetch category, brand, sale, set or search listing URLs, used in `listingUrls` mode. Both `.com` and `.cn` URLs are accepted. |\n| `productUrls` | array | `[]` | Farfetch product page URLs to scrape directly, used in `productDetails` mode. Both `.com` and `.cn` URLs are accepted. |\n| `maxItems` | integer | `20` | Maximum number of products to return (1–2500) |\n\n`category` mode follows the department in the selected category path, so `gender` is not combined with it. The other listing modes use `gender`; when it is empty they use the women's storefront.\n\n### Example: keyword search in USD\n\n```json\n{\n  \"mode\": \"search\",\n  \"keyword\": \"Prada shoes\",\n  \"locale\": \"nz\",\n  \"maxItems\": 30\n}\n```\n\n### Example: women's bags under 1,500 USD, cheapest first\n\n```json\n{\n  \"mode\": \"category\",\n  \"category\": \"women/bags-purses-1\",\n  \"locale\": \"nz\",\n  \"priceMax\": 1500,\n  \"sortBy\": \"priceLowToHigh\",\n  \"maxItems\": 50\n}\n```\n\n### Example: black or brown men's shoes on sale\n\n```json\n{\n  \"mode\": \"category\",\n  \"category\": \"men/shoes-2\",\n  \"locale\": \"uk\",\n  \"colors\": [\"Black\", \"Brown\"],\n  \"discountRange\": \"30to50\",\n  \"sortBy\": \"saleHighToLow\",\n  \"maxItems\": 40\n}\n```\n\n### Example: everything from one designer, women's only, GBP\n\n```json\n{\n  \"mode\": \"searchByBrand\",\n  \"brand\": \"balenciaga\",\n  \"gender\": \"women\",\n  \"locale\": \"uk\",\n  \"maxItems\": 50\n}\n```\n\n### Example: new arrivals in EUR\n\n```json\n{\n  \"mode\": \"newIn\",\n  \"gender\": \"women\",\n  \"locale\": \"fr\",\n  \"sortBy\": \"newest\",\n  \"maxItems\": 40\n}\n```\n\n### Example: scrape a filtered listing URL\n\n```json\n{\n  \"mode\": \"listingUrls\",\n  \"listingUrls\": [\n    \"https://www.farfetch.com/uk/shopping/women/sale/bags-purses-1/items.aspx?sort=5&colour=1&price=100-2000\"\n  ],\n  \"locale\": \"uk\",\n  \"maxItems\": 60\n}\n```\n\n### Example: look up specific products\n\n```json\n{\n  \"mode\": \"productDetails\",\n  \"locale\": \"nz\",\n  \"productUrls\": [\n    \"https://www.farfetch.com/shopping/women/gucci-gg-marmont-shoulder-bag-item-12345678.aspx\"\n  ]\n}\n```\n\n## Use cases\n\n- **Price monitoring** — track a designer's catalog or a whole category for price changes and new discounts in a chosen market\n- **Sale tracking** — pull sale items or discount bands regularly to catch markdowns as they appear\n- **Category research** — compare pricing and stock across women's, men's and kids' categories in different markets\n- **Trend forecasting** — scan new arrivals by gender to see what's launching across brands\n- **Catalog enrichment** — feed product URLs through `productDetails` to backfill price, sizes, color, condition, category and material data\n\n## FAQ\n\n**Do I need a Farfetch account or cookies?** No. Only publicly available product listings are read; no login, account or cookies are required.\n\n**Which market and currency should I use?** Use the `locale` that matches your target market. `nz` returns USD, `uk` returns GBP, `fr`/`de`/`it`/`es`/`ie` return EUR, and the other options return their local currencies. Farfetch prices are market-local, so the same product can cost different amounts in different storefronts.\n\n**Why does a product have no `originalPrice` or `discountPercent`?** Those fields only appear when the item is actually marked down; full-price items simply don't carry a discount.\n\n**What do `category` and `categories` mean?** Farfetch groups products in a breadcrumb below the brand. `categories` keeps the full trail and `category` is the deepest one, so a bag can come back as `[\"Bags\", \"Shoulder Bags\"]` and `Shoulder Bags`.\n\n**What is `condition`?** Farfetch marks new products as `new` and pre-owned products as `used`. Pre-owned listings often also have a Pre-Owned category in the breadcrumb.\n\n**Can I filter by size?** Size filtering is not exposed as an input. Farfetch's listing URL accepts only opaque internal numeric size IDs; letter sizes return a server error and the same ID means different labels on different size scales. Sizes are reported per product in `sizes` and per variant in `variants`, so filter the dataset on those fields after the run.\n\n**Can I combine filters?** Yes — category, brand or search mode can be combined with `gender`, `sortBy`, `colors`, `priceMin`, `priceMax` and `discountRange` in one run.\n\n**How many products can one run return?** Up to `maxItems`, capped at 2500. Listings return up to 180 products per page and paginate until the items run out; the source has no fixed page ceiling. For more than 2500, run separate categories, brands, price bands or discount bands and combine the datasets — deduplicate on `productId`.\n\n**Do I get the boutique and brand style code?** Yes, in `productDetails` mode: `boutique` is the seller name and `styleCode` is the brand style ID. Farfetch-owned products do not publish a boutique name, so that field is omitted for those records.\n\n**Why do some category URLs return no products?** Farfetch uses different category paths in different markets. Use the `category` dropdown, which contains only verified live paths, or search by keyword or brand.\n\n**Does Farfetch publish product ratings or reviews?** No. The regional product pages carry no per-product rating, review count or review text; the \"4.7/5 stars\" copy is Farfetch's site-wide marketing, not a product rating. Those fields are therefore not emitted.\n\n**Are prices the same as farfetch.com US?** No. The global `farfetch.com` host blocks automated access, so this actor uses Farfetch's regional storefronts. Prices and availability are local to the selected storefront and should be treated as market-specific.\n\n**Is this affiliated with Farfetch?** No. This is an independent, third-party actor that reads Farfetch's publicly available product pages; it is not operated by or affiliated with Farfetch.\n",
      "input": {
        "title": "Farfetch Scraper Input",
        "description": "Search Farfetch luxury fashion by keyword, brand, category, gender, or sale items across regional storefronts.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "What to browse on Farfetch.",
            "editor": "select",
            "enum": [
              "search",
              "searchByBrand",
              "category",
              "newIn",
              "saleItems",
              "listingUrls",
              "productDetails"
            ],
            "enumTitles": [
              "Search by keyword",
              "Browse by brand",
              "Browse a category",
              "New arrivals",
              "Sale items",
              "Scrape listing URLs",
              "Get product details by URLs"
            ],
            "default": "search",
            "prefill": "search"
          },
          "locale": {
            "title": "Storefront / currency",
            "type": "string",
            "description": "Regional Farfetch storefront. Prices and availability are local to the selected market.",
            "editor": "select",
            "enum": [
              "nz",
              "uk",
              "fr",
              "de",
              "it",
              "es",
              "ie",
              "hk",
              "mo",
              "cn",
              "sg",
              "jp",
              "kr",
              "au",
              "ca",
              "ae",
              "tw"
            ],
            "enumTitles": [
              "New Zealand (USD)",
              "United Kingdom (GBP)",
              "France (EUR)",
              "Germany (EUR)",
              "Italy (EUR)",
              "Spain (EUR)",
              "Ireland (EUR)",
              "Hong Kong (HKD)",
              "Macau (HKD)",
              "Mainland China (CNY)",
              "Singapore (SGD)",
              "Japan (JPY)",
              "South Korea (KRW)",
              "Australia (AUD)",
              "Canada (CAD)",
              "United Arab Emirates (AED)",
              "Taiwan (TWD)"
            ],
            "default": "nz",
            "prefill": "nz"
          },
          "keyword": {
            "title": "Search keyword",
            "type": "string",
            "description": "Product keyword to search for (mode=search), e.g. 'Gucci bag', 'Prada shoes'.",
            "editor": "textfield",
            "default": "Gucci bag",
            "prefill": "Gucci bag"
          },
          "brand": {
            "title": "Brand (mode=searchByBrand)",
            "type": "string",
            "description": "Brand name or slug to browse (e.g. 'gucci', 'prada', 'balenciaga').",
            "editor": "textfield"
          },
          "gender": {
            "title": "Gender",
            "type": "string",
            "description": "Filter by gender for search, brand, new-arrivals and sale modes. Category mode follows the department in the selected category. When omitted, listings use the women's storefront.",
            "editor": "select",
            "enum": [
              "",
              "women",
              "men",
              "kids"
            ],
            "enumTitles": [
              "All genders",
              "Women",
              "Men",
              "Kids"
            ],
            "default": "",
            "prefill": ""
          },
          "category": {
            "title": "Category (mode=category)",
            "type": "string",
            "description": "Farfetch department and category to browse. Each option is a live catalog path, e.g. 'Women - Bags' or 'Men - Shoes'.",
            "editor": "select",
            "enum": [
              "women/clothing-1",
              "women/shoes-1",
              "women/bags-purses-1",
              "women/accessories-all-1",
              "women/jewellery-1",
              "women/watches-1",
              "women/pre-owned-1",
              "women/activewear-1",
              "women/lingerie-hosiery-1",
              "women/lifestyle-1",
              "women/fine-jewellery-6",
              "women/demi-fine-jewellery-1",
              "men/clothing-2",
              "men/shoes-2",
              "men/bags-purses-2",
              "men/accessories-all-2",
              "men/jewellery-2",
              "men/watches-4",
              "men/pre-owned-2",
              "men/activewear-2",
              "men/underwear-socks-2",
              "men/lifestyle-2",
              "kids/boys-clothing-3",
              "kids/boys-shoes-3",
              "kids/boys-accessories-3",
              "kids/girls-clothing-4",
              "kids/girls-shoes-4",
              "kids/girls-accessories-1",
              "kids/baby-boy-clothing-5",
              "kids/baby-boy-shoes-5",
              "kids/baby-boy-accessories-5",
              "kids/baby-girl-clothing-6",
              "kids/baby-girl-shoes-6",
              "kids/baby-girl-accessories-6",
              "kids/teen-boy-clothing-8",
              "kids/teen-boy-accessories-8",
              "kids/teen-boy-shoes-1",
              "kids/teen-girl-clothing-7",
              "kids/teen-girl-accessories-7",
              "kids/teen-girl-shoes-1",
              "kids/baby-nursery-5"
            ],
            "enumTitles": [
              "Women - Clothing",
              "Women - Shoes",
              "Women - Bags",
              "Women - Accessories",
              "Women - Jewellery",
              "Women - Watches",
              "Women - Pre-Owned",
              "Women - Activewear",
              "Women - Lingerie & Nightwear",
              "Women - Homeware",
              "Women - Fine Jewellery",
              "Women - Demi-Fine Jewellery",
              "Men - Clothing",
              "Men - Shoes",
              "Men - Bags",
              "Men - Accessories",
              "Men - Jewellery",
              "Men - Watches",
              "Men - Pre-Owned",
              "Men - Activewear",
              "Men - Underwear & Socks",
              "Men - Homeware",
              "Kids - Boys Clothing",
              "Kids - Boys Shoes",
              "Kids - Boys Accessories",
              "Kids - Girls Clothing",
              "Kids - Girls Shoes",
              "Kids - Girls Accessories",
              "Kids - Baby Boy Clothing",
              "Kids - Baby Boy Shoes",
              "Kids - Baby Boy Accessories",
              "Kids - Baby Girl Clothing",
              "Kids - Baby Girl Shoes",
              "Kids - Baby Girl Accessories",
              "Kids - Teen Boy Clothing",
              "Kids - Teen Boy Accessories",
              "Kids - Teen Boy Shoes",
              "Kids - Teen Girl Clothing",
              "Kids - Teen Girl Accessories",
              "Kids - Teen Girl Shoes",
              "Kids - Baby Nursery"
            ],
            "default": "women/bags-purses-1"
          },
          "sortBy": {
            "title": "Sort order",
            "type": "string",
            "description": "Order of listing results. Applies to search, brand, category, new-arrivals and sale modes.",
            "editor": "select",
            "enum": [
              "recommended",
              "newest",
              "priceHighToLow",
              "priceLowToHigh",
              "saleHighToLow"
            ],
            "enumTitles": [
              "Recommended",
              "Newest first",
              "Price: high to low",
              "Price: low to high",
              "Biggest discount first"
            ],
            "default": "recommended"
          },
          "colors": {
            "title": "Colors",
            "type": "array",
            "description": "Only include products in these colors. Leave empty for every color.",
            "editor": "select",
            "uniqueItems": true,
            "items": {
              "type": "string",
              "enum": [
                "Black",
                "White",
                "Grey",
                "Neutrals",
                "Brown",
                "Green",
                "Blue",
                "Red",
                "Pink",
                "Yellow",
                "Metallic",
                "Multicolour",
                "Gold",
                "Silver",
                "Purple",
                "Orange"
              ]
            },
            "default": []
          },
          "priceMin": {
            "title": "Minimum price",
            "type": "integer",
            "description": "Lowest price to include, in the selected storefront's currency. Leave empty for no minimum.",
            "minimum": 0,
            "maximum": 1000000
          },
          "priceMax": {
            "title": "Maximum price",
            "type": "integer",
            "description": "Highest price to include, in the selected storefront's currency. Leave empty for no maximum.",
            "minimum": 0,
            "maximum": 1000000
          },
          "discountRange": {
            "title": "Discount",
            "type": "string",
            "description": "Only include products in this Farfetch sale-discount band. The matching value per product is saleDiscountPercent. Applies to search, brand, category, new-arrivals and sale modes.",
            "editor": "select",
            "enum": [
              "",
              "none",
              "upTo30",
              "30to50",
              "50to60",
              "60plus"
            ],
            "enumTitles": [
              "Any discount",
              "No discount",
              "Up to 30% off",
              "30% - 50% off",
              "50% - 60% off",
              "60%+ off"
            ],
            "default": ""
          },
          "listingUrls": {
            "title": "Listing URLs (mode=listingUrls)",
            "type": "array",
            "description": "Farfetch category, brand, sale, set or search listing URLs. Both farfetch.com and farfetch.cn URLs are accepted; every listing starts at page 1 with 180 products per page.",
            "editor": "stringList",
            "default": []
          },
          "productUrls": {
            "title": "Product URLs (mode=productDetails)",
            "type": "array",
            "description": "Farfetch product page URLs to scrape. Both farfetch.com and farfetch.cn URLs are accepted and converted to the selected storefront.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Maximum number of products to return (1-2500).",
            "minimum": 1,
            "maximum": 2500,
            "default": 20,
            "prefill": 3
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Farfetch Luxury Fashion Price & Discount Extractor Output",
        "description": "Farfetch product records with local price, original price, total discount, Farfetch sale discount, currency, category, condition, boutique, brand style code, stock, sizes, color, images and product URL.",
        "properties": {
          "products": {
            "type": "string",
            "title": "Farfetch products",
            "description": "Dataset of scraped Farfetch products.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Farfetch Products",
              "transformation": {
                "fields": [
                  "brand",
                  "title",
                  "boutique",
                  "styleCode",
                  "price",
                  "originalPrice",
                  "discountPercent",
                  "currency",
                  "locale",
                  "gender",
                  "category",
                  "condition",
                  "stockQuantity",
                  "position",
                  "productUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.2.1",
    "imageDigest": "4df9c0ed00c15177b8be55304825252b6c8a4d843293b4a5c8f17840a1c46988",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.2"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.005884444444444445
    }
  }
}