yoox.com APIyoox.com ↗
Access YOOX's fashion catalog via API. Search products, browse categories by department, get full product details, new arrivals, and sale items.
curl -X GET 'https://api.parse.bot/scraper/b0e5fca3-bf37-47ff-b329-d13dd7b3aead/search_products?limit=5&query=dresses&sort_by=price_asc' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on YOOX with optional filters and sorting. Returns paginated results from the YOOX catalog.
| Param | Type | Description |
|---|---|---|
| page | integer | Zero-based page number. |
| brand | string | Brand name or ID to filter by (e.g. 'FERRAGAMO-753'). Use get_designers_list to discover available brand IDs. |
| limit | integer | Number of results per page. |
| queryrequired | string | Search keyword (e.g. 'shoes', 'dresses'). |
| sort_by | string | Sort order. Accepted values: 'price_asc', 'price_desc', 'newest'. |
| max_price | number | Maximum price filter in USD. |
| min_price | number | Minimum price filter in USD. |
{
"type": "object",
"fields": {
"page": "integer current page number",
"pages": "integer total number of pages",
"total": "integer total number of matching products",
"products": "array of product objects with product_id, name, brand, category, current_price, original_price, retail_price, currency, discount_percentage, available_sizes, images, product_url, composition, color"
},
"sample": {
"data": {
"page": 0,
"pages": 4000,
"total": 38573,
"products": [
{
"name": "VERO MODA Mini dresses",
"brand": "VERO MODA",
"color": "Black",
"images": [
"https://www.yoox.com/images/items/15/15330984JG_11_f.jpg"
],
"category": "Mini dresses",
"currency": "USD",
"product_id": "15330984JG",
"composition": "70% Tencel™ Modal, 30% Polyester",
"product_url": "https://www.yoox.com/us/15330984JG/item",
"retail_price": 27,
"current_price": 15,
"original_price": 27,
"available_sizes": [
"XS"
],
"discount_percentage": 44.44
}
]
},
"status": "success"
}
}About the yoox.com API
The YOOX API provides 7 endpoints for querying the YOOX fashion catalog across women's, men's, kids', and design/art departments. You can run keyword searches with price and brand filters via search_products, retrieve full item details including composition, imagery, and pricing via get_product_detail, and enumerate available designers with get_designers_list to build precise brand-filtered queries.
Search and Browse the YOOX Catalog
search_products accepts a required query string alongside optional filters: brand (using IDs obtained from get_designers_list), min_price, max_price, and sort_by (price_asc, price_desc, or newest). Results are paginated using zero-based page and limit parameters. Each product object in the response carries product_id, name, brand, category, current_price, original_price, retail_price, currency, and discount_p (discount percentage). get_product_listing_by_category works similarly but navigates by department (women, men, kids, designart) with an optional category keyword like shoes or jackets.
Product Detail and Taxonomy Endpoints
get_product_detail takes a single item_code (e.g. 15463659FH) obtained from any listing endpoint and returns extended fields not present in list responses: color, composition, images (array of image URLs), and product_url. This is the endpoint to use when you need full material and media data for a specific item.
get_categories returns grouped navigation categories for a given department, with each group exposing a group_name and an items array of name and url pairs — useful for building category-aware navigation. get_designers_list returns each designer's name and id, where the id maps directly to the brand filter in search_products.
New Arrivals and Sale Items
get_new_arrivals and get_sale_items both accept an optional gender (women or men) and return paginated product lists with the same field shape as other listing endpoints, including discount_p on sale items to surface markdown percentages.
- Build a price-comparison tool that tracks
current_pricevsoriginal_priceacross YOOX sale items usingget_sale_items - Populate a brand directory by iterating
get_designers_listacross all four departments and aggregating designer coverage - Monitor new inventory additions for specific departments by polling
get_new_arrivalsand diffingproduct_idsets - Construct a filtered product feed by chaining
get_designers_listto retrieve brand IDs, then passing them intosearch_products - Extract material and composition data at scale using
get_product_detailfor sustainability or product classification workflows - Build a category-aware shopping interface using the grouped navigation structure returned by
get_categories - Identify highest-discount items across departments by sorting
get_sale_itemsresults ondiscount_p
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does YOOX offer an official developer API?+
What does `get_product_detail` return that listing endpoints don't?+
get_product_detail returns fields absent from paginated listing responses: color, composition (material breakdown), an images array of URLs, and product_url pointing to the item's page on YOOX. Listing endpoints return pricing and discount data but omit these extended attributes.How do I filter search results by a specific brand?+
get_designers_list with the relevant department to retrieve designer id values, then pass that ID string as the brand parameter in search_products. For example, FERRAGAMO-753 is one such ID. The get_designers_list endpoint is the canonical source for valid brand filter values.Does the API cover product reviews, stock availability, or size information?+
Are the `get_new_arrivals` and `get_sale_items` endpoints limited to women's and men's?+
women or men as the gender parameter. Kids' and designart departments are accessible through get_product_listing_by_category using kids or designart as the department value, but they do not have dedicated new-arrival or sale endpoints. You can fork the API on Parse and revise it to add that coverage.