reserved.com APIreserved.com ↗
Access Reserved.com's full product catalog, category tree, keyword search, detailed product info, and in-store stock availability via 6 structured endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/0216d37e-57d9-471f-9b8b-dc6e4c2e809f/get_homepage' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetches the Reserved Hungary homepage information and promotional banner URLs extracted from the page.
No input parameters required.
{
"type": "object",
"fields": {
"url": "string homepage URL",
"title": "string site title",
"status": "string indicating site availability",
"banners": "array of promotional and product page URLs found on the homepage"
},
"sample": {
"data": {
"url": "https://www.reserved.com/hu/hu/",
"title": "Reserved Hungary",
"status": "online",
"banners": [
"https://www.reserved.com/hu/hu/",
"https://www.reserved.com/hu/hu/balloon-nadrag-modallal-2-938jj-01x",
"https://www.reserved.com/hu/hu/borben-gazdag-papucs-623ie-99x"
]
},
"status": "success"
}
}About the reserved.com API
The Reserved.com API exposes 6 endpoints covering the full shopping experience on reserved.com, including category discovery, paginated product listings, keyword search, and per-SKU detail pages. The list_products endpoint supports filtering by size, color, and price range in HUF, while check_store_availability returns physical store stock status for a given product and size ID. Data covers Reserved Hungary's catalog with fields like SKU, pricing, color options, features, and ratings.
Category and Product Discovery
Start with list_categories to retrieve the full category tree. Each category object includes an id, name, url, and nested children array, so you can traverse the hierarchy to find the category_id values needed by list_products. For example, category ID 239 maps to Women's. list_products accepts that ID along with optional filters: sizes (comma-separated slugs like s,m,l), colors, min_price, max_price (both in HUF), and sort_by. The response includes products (an array of summary objects with id, name, sku, price, images, sizes, and colorOptions), plus productsAmount and productsTotalAmount for pagination tracking.
Search and Product Detail
search_products accepts a query string and returns Algolia-backed results. The response structure mirrors Algolia's multi-index format: an array of result objects each containing hits, nbHits, nbPages, page, and query. Pagination is zero-based via the page parameter. For full product data, pass a SKU string to get_product_detail to retrieve description, a features object (mapping feature category names to arrays of values), final_price, regular_price, currency, color_options, and sizes. This endpoint is the appropriate source for sale pricing since it exposes both regular and final price fields.
Store Availability
check_store_availability takes a numeric product_id and size_id (both sourced from product detail or list responses) and an optional location string to target nearby stores. The response includes a boolean status and, when available, store detail objects. Note that the upstream service occasionally returns a Hungarian-language technical error (Technikai probléma); in those cases status will be false and a message field will be present. The get_homepage endpoint returns the site title, a status indicator, and an array of promotional banners URLs extracted from the homepage, useful for tracking active campaigns.
- Build a price comparison tool using
final_priceandregular_pricefields to surface discounted Reserved items - Sync Reserved's product catalog into an internal database using
list_categoriesand paginatedlist_productscalls - Power a size-and-color filtered product feed by combining the
sizesandcolorsparams inlist_products - Check real-time in-store stock for a specific SKU and size before recommending a store visit via
check_store_availability - Implement keyword search across all Reserved categories using
search_productswith Algolia-backed hit counts - Track promotional campaign URLs over time by polling the
bannersarray returned byget_homepage - Extract structured garment attributes from the
featuresobject inget_product_detailto enrich product metadata
| 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 Reserved.com have an official public developer API?+
What does `list_products` return and how do I filter results?+
list_products returns an array of product summary objects per page, each containing id, name, sku, price, images, sizes, and colorOptions, along with productsAmount and productsTotalAmount. You can filter by passing sizes (e.g. s,m,l), colors, min_price, or max_price as optional parameters alongside the required category_id. Pagination is zero-based via the page parameter.What happens when `check_store_availability` returns an error?+
status: false and a message field containing the Hungarian-language error string Technikai probléma. Your integration should handle this case by checking the status boolean before consuming store detail objects.Does the API cover Reserved stores outside Hungary, such as Poland or Romania?+
Does the API return customer reviews or ratings for products?+
get_product_detail endpoint includes rating data as part of the product detail response, but there is no endpoint that returns individual user reviews or review text. You can fork this API on Parse and revise it to add a dedicated reviews endpoint if that data is available on the product page.