mango.com APImango.com ↗
Access Mango's product catalog via API: browse categories, list products by catalog, get details, search, and fetch new arrivals across women, men, kids, and home.
curl -X GET 'https://api.parse.bot/scraper/22863229-eec5-4608-b9c0-7b001356f57b/get_categories?gender=women' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns the navigation category tree for a given gender/department from Mango. Each menu item contains sub-menus with catalog IDs usable in list_products.
| Param | Type | Description |
|---|---|---|
| gender | string | Gender/department to filter by. Accepted values: 'women', 'men', 'teen', 'kids', 'home'. Omitting returns all departments. |
{
"type": "object",
"fields": {
"menus": "array of category menu objects, each containing id, labelId, url, and nested menus with catalogId"
},
"sample": {
"data": {
"menus": [
{
"id": "she",
"url": "/hu/en/h/women",
"type": "BRAND",
"appId": "she",
"menus": [
{
"id": "nuevo",
"url": "/hu/en/c/women/new-now/56b5c5ed",
"type": "CATALOG",
"appId": "she.sections_she.nuevo",
"labelId": "header.secciones.nuevo",
"catalogId": "nuevo"
}
],
"labelId": "tiendas.mujer"
}
]
},
"status": "success"
}
}About the mango.com API
The Mango API covers 6 endpoints that expose the full mango.com product catalog, including category navigation, product listings, detail pages, search suggestions, new arrivals, and similar product references. The get_product_details endpoint alone returns structured data across name, per-color image sets, per-size stock availability, and color-keyed pricing — giving you the same depth visible on a product page without manual browsing.
Category and Catalog Navigation
The get_categories endpoint returns Mango's full navigation tree, optionally filtered by department using the gender parameter ('women', 'men', 'teen', 'kids', 'home'). Each menu object includes an id, labelId, url, and nested sub-menus that carry catalogId values. Those catalogId strings (e.g. 'prendas_she.vaqueros_she') feed directly into list_products to retrieve the items in any category.
Product Listings and Details
list_products takes a catalog_id and returns an items object keyed by productId:colorId. Each entry exposes productId, colorId, colorGroup, sizes, price, and families. The endpoint also returns a filters array (covering subfamilies, color groups, sizes, and price range) and a gridSize indicator. For full product information, get_product_details accepts a product_id and returns name, a colors array with per-color images, sizes, and relatedProductId, a stock object keyed by color and size, and a prices object keyed by color ID.
Search and Discovery
search_products accepts a free-text query and returns a suggestions array grouped by index. Each suggestion carries a searchterm and nrResults count, which is useful for building autocomplete or validating query relevance before fetching a full listing. get_new_arrivals mirrors list_products in its response shape but automatically resolves the correct new-arrivals catalog for a given gender, saving a round-trip through get_categories.
Similar Products
get_similar_products accepts a product_id and returns a related_products array, where each entry contains a product_id and the associated color label. These references come from the color-variant links within a product and can be used to surface alternatives or build recommendation flows without additional catalog traversal.
- Mirror Mango's category tree in a fashion aggregator, using catalogId values from get_categories to keep department links current.
- Track price changes across colorways by polling get_product_details for specific product IDs and comparing the prices object over time.
- Build a stock availability checker that reads the stock object from get_product_details to alert users when a size restocks.
- Populate an autocomplete search field using the suggestions and nrResults fields returned by search_products.
- Generate a new-arrivals feed segmented by gender using get_new_arrivals with the gender parameter.
- Build a 'you may also like' recommendation widget by chaining get_similar_products with get_product_details for each related product_id.
- Export catalog data by size and color group using the filters array from list_products to segment inventory analysis.
| 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.