Farfetch API endpoint
Returns 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.
/farfetch/designersQuery parameters:
gender (required) — department. Allowed values: women, men,
kids.Notable response behavior:
gender value returns 400 before any upstream request
is made.women, 289 for men, 58 for kids as of this endpoint's build).| Field | Filled in, of 5275 checked | Values in the sample |
|---|---|---|
| name | 500 | “A BATHING APE®” and 499 other values |
| slug | 500 | |
| url | 500 | farfetch.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| gender | string | Yes | Department: women, men, kids | women | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/farfetch/designers?gender=women" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"gender": "women",
"count": 485,
"designers": [
{
"name": "A BATHING APE®",
"slug": "bape",
"url": "https://www.farfetch.com/shopping/women/bape/items.aspx"
},
{
"name": "Gucci",
"slug": "gucci",
"url": "https://www.farfetch.com/shopping/women/gucci/items.aspx"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/farfetch.designersResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | farfetch.DesignersResponse | No | ||||
| data.count | integer | No | ||||
| data.designers | array | No | ||||
| data.designers[].name | string | No | ||||
| data.designers[].slug | string | No | ||||
| data.designers[].url | string | No | ||||
| data.gender | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/farfetch/designers?gender=women" \
-H "x-api-key: $CRAWLORA_API_KEY"