API Reference
Browse Farfetch's luxury multi-brand marketplace by department, designer, and category, and get full product detail as structured JSON. 4 endpoints documented below.
curl "https://api.crawlora.net/api/v1/farfetch/search?designer=gucci&gender=women" \
-H "x-api-key: $CRAWLORA_API_KEY"Crawlora's Farfetch endpoints return department categories, designer directories, browse results, and product detail from Farfetch's luxury marketplace as normalized JSON with one API key. Farfetch's strength is detail rather than filtering. /farfetch/product returns every size variant with its own price and availability, and the designer directory is exhaustive: on 2026-09-18 the women's department listed 476 designers, from A BATHING APE® (slug bape) onward. A second pull on 2026-10-27 showed the category directory returning 3 genders with empty category lists, and the designer directory failing with a parser-drift error.
/farfetch/categories fetches women, men, and kids independently. If one department fails, that department comes back with an empty categories list and the call still succeeds, so check each department's list before relying on it.
/farfetch/designers requires gender and returns every current designer with a name, slug, and URL: 476 for women on 2026-09-18. The slug is what /farfetch/search's designer filter expects.
/farfetch/search takes gender plus optional designer and category, and page walks the listing's total_pages. It has no keyword, price, sale, or sort parameters, so apply those filters in your own code.
/farfetch/product takes gender and the product slug from a search result's id, such as gucci-slide-sandals-with-double-g-item-37690086. It returns brand, color, description, images, a category breadcrumb, and each size variant's price and availability. An invalid slug returns 400 and an unknown product 404.
categories returned three genders (women first), each with 0 categories. Do not conclude Farfetch has no categories; try again later and keep the retrieval time.
designers for women returned a 503 describing an invalid hydration state, which means the site markup changed. Retry with backoff and alert on repeated failures.
/farfetch/categoriesapiKey2 credits/requestReturns every department's top-level category directory (name, slug, URL). Each slug is usable directly as the category filter on GET /farfetch/search. Public data sourced live from Farfetch's own listing pages.
Takes no parameters.
Sampled 14 Oct 2026: 3 items. Filled in every item: gender. Not in every item: categories (0).
/farfetch/designersapiKey3 credits/requestReturns a department's full designer directory (name, slug, URL). Each slug is usable directly as the designer filter on GET /farfetch/search. Public data sourced from Farfetch's own designer-directory pages.
Required: gender.
Sampled 14 Oct 2026: 5275 items. Not in every item: name (500), slug (500), url (500). In the sample: name: “A BATHING APE®” and 499 other values; url: farfetch.com.
/farfetch/productapiKey5 credits/requestReturns a Farfetch product's full detail: name, brand, color, description, images, category breadcrumb, and every size variant with its own price and availability. Public data sourced from Farfetch's own product pages.
Required: gender, slug.
Sampled 14 Oct 2026: 7 items. Filled in every item: sku, size, price, currency, in_stock. In the sample: size: 36.5 to 40, median 38; in_stock: true in 7 of 7; price: 516 to 563, median 516.
/farfetch/searchapiKey5 credits/requestBrowses Farfetch's luxury multi-brand marketplace by department plus a designer and/or category filter (at least one is required), returning listing summaries (name, brand, price, image, availability) and the upstream page count.
Required: gender. Optional: designer, category, page.
Sampled 14 Oct 2026: 60 items. Filled in every item: id, url, name, brand, image_url, price, currency, in_stock. In the sample: price: 510 to 6,830, median 1,525; name: “GG cotton canvas fabric zip jacket” and 53 other values; url: farfetch.com; in_stock: true in 60 of 60; image_url: cdn-images.farfetch-contents.com.
Results from the 7 days to 14 Oct 2026. Current status
| Endpoint | Request | Checks passed | Median response |
|---|---|---|---|
| Farfetch category directory | GET /farfetch/categories | 99.9% | 49.17 s |
| Farfetch designer directory | GET /farfetch/designers?gender=women | 60.1% | 11.49 s |
| Farfetch product detail | GET /farfetch/product?gender=women&slug=gucci-slide-sandals-with-double-g-item-37690086 | 96.8% | 7.52 s |
| Search Farfetch listings | GET /farfetch/search?designer=gucci&gender=women | 98% | 7.69 s |