Reserved APIreserved.com ↗
Access Reserved.com's product catalog, search, pricing, store availability, and top discounts via 7 structured API endpoints. Covers Polish and Hungarian stores.
What is the Reserved API?
The Reserved.com API provides 7 endpoints covering the full shopping workflow: browsing the category tree with list_categories, searching across all categories with search_products, retrieving full product detail via get_product_detail, checking in-store stock with check_store_availability, and surfacing the top 50 discounted products from the Polish store with get_best_deals. Prices are returned in HUF for Hungarian endpoints and PLN for the Polish deals endpoint.
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 API
Category Browsing and Product Listing
list_categories returns the full hierarchical category tree — each node carries an id, name, url, and nested children array. Those id values feed directly into list_products, which accepts category_id as a required parameter. list_products supports zero-based page and limit pagination, min_price/max_price filters in HUF, and comma-separated sizes and colors slugs. Each result object includes id, name, sku, price, images, sizes, and colorOptions. The response also exposes productsTotalAmount so callers can compute pagination without an extra request.
Product Search and Detail
search_products accepts a query string and returns paginated results in the results array. Each hit includes a sku field that can be passed directly to get_product_detail. The detail endpoint returns description, a features object mapping feature categories to value arrays, regular_price, final_price, currency, sizes, and color_options — making it straightforward to detect discounted items by comparing the two price fields.
Store Availability and Promotions
check_store_availability takes a numeric product_id and size_id (both sourced from product detail or list responses) and an optional location string. The response returns a status boolean and a message when the upstream service cannot fulfil the request — the Hungarian-language error 'Technikai probléma' may appear in that field. get_best_deals requires no parameters and scans the entire Polish catalogue, returning the top 50 discounted products sorted by discount depth, a discounted_products_scanned count, and a promotions array that includes active coupon code values (or null) and a source label distinguishing homepage banners from code-based promotions.
The Reserved API is a managed, monitored endpoint for reserved.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when reserved.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official reserved.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a price-drop tracker by polling
get_product_detailand comparingregular_pricetofinal_priceover time. - Aggregate the current top discounts from the Polish store using
get_best_dealsto populate a deals newsletter. - Filter in-stock sizes and colors in a specific category using
list_productswithsizes,colors, and price range parameters. - Power a store-locator feature by passing a city name to
check_store_availabilityfor a given product and size. - Index the full category tree from
list_categoriesto map Reserved's taxonomy for a comparison shopping tool. - Extract active coupon codes from the
promotionsarray inget_best_dealsfor a browser extension or deal aggregator. - Cross-reference
search_productshits withget_product_detailto enrich search results with descriptions and feature metadata.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Reserved.com have an official developer API?+
What does `get_best_deals` actually return, and which store does it cover?+
get_best_deals covers the Polish Reserved store (reserved.com/pl/pl) only. It returns up to 50 products ranked by discount depth, each with id, sku, name, and url, plus a promotions array that includes the promotion title, url, a coupon code (or null if none), and a source field indicating whether the promotion came from a homepage banner or a discount-code page. It also returns discounted_products_total and discounted_products_scanned so callers know the coverage of the ranking.What happens when `check_store_availability` cannot return store data?+
status: false and a message string. In some cases that message is the Hungarian-language string 'Technikai probléma', indicating a transient upstream error. Callers should handle this gracefully by checking the status field before reading store detail fields.Does the API cover Reserved stores outside Hungary and Poland, or include order/cart functionality?+
get_best_deals covers the Polish store with prices in PLN. Other regional stores (e.g. Czech, Romanian) and any order, cart, or account functionality are not covered. You can fork this API on Parse and revise it to add endpoints targeting other regional domains.How are categories and products linked for pagination?+
list_categories returns id values for every node in the tree. Pass one of those IDs as the required category_id parameter to list_products. Use the zero-based page parameter alongside limit to page through results; the productsTotalAmount field in the response tells you the total count so you can calculate how many pages remain without an additional request.