API Reference
Search or browse YOOX's multi-brand catalog by department, get full product detail, and browse the category and designer directories as structured JSON. 4 endpoints documented below.
curl -X GET "https://api.crawlora.net/api/v1/yoox/search?department=women&q=coffee&on_sale=true&sort=relevance&page=1&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"Crawlora's YOOX endpoints return categories, designers, search results, and product detail from YOOX's off-season designer outlet as normalized JSON with one API key. YOOX sells past-season stock at a discount, and the search endpoint reflects that. It has an on_sale filter and a sort=discount option that ranks listings by markdown size. Farfetch, a full-price marketplace, has neither. YOOX's four routes depend on a required department and on slugs from the directory routes, and the documentation warns that calls can take about 80 seconds or return 503 during maintenance.
Every search is scoped to one department: women, men, or kids. /yoox/categories returns all three departments' category slugs in one response, and /yoox/designers returns one department's designer slugs, such as gucci.
/yoox/search takes the department plus any mix of q, category, designer, color, size, price_min, price_max, and on_sale. Sort with relevance, newest, price_asc, price_desc, or discount, and page with page and limit.
/yoox/product takes the product's full YOOX URL from a search result, not a slug, and returns price, availability, brand, description, images, and category.
YOOX pages are rendered through a headless browser behind Akamai Bot Manager, so calls are slower than plain API requests. A 503 (yoox render failed) means the challenge wasn't cleared, not that nothing matched. Retry with backoff.
search requires a department, and designers accepts women, men or kids. Every category slug from the categories route is valid as category in search, and every designer slug from the designers route is valid as designer.
Calls can take up to about 80 seconds, and a call that cannot finish, or one made while YOOX shows its maintenance page, returns 503. Use long timeouts and retries with backoff.
search takes q, category, designer, color, size, price_min, price_max and on_sale, sorts by relevance, newest, price_asc, price_desc or discount, and limits results to 1 to 100. Each product has brand, name, price, currency, stock status, image and URL, plus facets for colors, sizes and sorts.
product takes the item id, the path segment before /item in a product URL such as 17734181OO; the older url parameter still works.
On 2026-10-30 /yoox/designers and /yoox/search both answered 503 YOOX is currently showing a maintenance page. Retry later; the 503 is not an empty catalog.
/yoox/categoriesapiKey5 credits/requestLists YOOX categories grouped by department (`women`, `men` and `kids`), each with its name, slug and URL. Every category slug is valid as `category` in YOOX search. Calls can take up to about 80 seconds, and a call that cannot finish, or one made while YOOX shows its maintenance page, returns `503`.
Takes no parameters.
/yoox/designersapiKey5 credits/requestLists YOOX designers for the required `department` (`women`, `men` or `kids`), with the `count` and each designer's name, slug and URL. Every designer slug is valid as `designer` in YOOX search. A call that cannot finish within about 80 seconds returns `503`, as does one made during YOOX maintenance.
Required: department (3 allowed values: women, men, kids).
Sampled 14 Oct 2026: 5 items. Filled in every item: name, slug, url. In the sample: name: “Top Designers” and 4 other values; url: yoox.com.
/yoox/productapiKey5 credits/requestReturns a YOOX product by item `id`, the path segment before `/item` in a product URL, for example `17734181OO`. The older `url` parameter still works instead. The response has name, brand, price, currency, `in_stock`, description, images and category. Calls can take up to about 80 seconds and return `503` if they cannot finish.
Optional: id, url.
/yoox/searchapiKey5 credits/requestSearches or browses YOOX products in the required `department`. Optional filters are `q`, `category`, `designer`, `color`, `size`, `price_min`, `price_max` and `on_sale`; `sort` takes `relevance`, `newest`, `price_asc`, `price_desc` or `discount`; `limit` is 1 to 100. Each product has brand, name, price, currency, stock status, image and URL, with `facets` for colors, sizes and sorts. May return `503`.
Required: department (3 allowed values: women, men, kids). Optional: q, category, designer, color, size, price_min, price_max, on_sale, sort (5 allowed values: relevance, newest, price_asc, price_desc, discount), page, limit.
Sampled 14 Oct 2026: 60 items. Filled in every item: id, url, name, brand, image_url, price, currency, in_stock. In the sample: price: 57 to 2,264, median 323; name: “Clutches” and 32 other values; url: yoox.com; in_stock: true in 60 of 60; brand: “THEMOIRè” and 37 other values; image_url: yoox.com.