jumbo.com APIwww.jumbo.com ↗
Search Jumbo supermarket products, browse the full category tree, and fetch autocomplete suggestions. Covers prices, promotions, brands, and facet filters.
curl -X GET 'https://api.parse.bot/scraper/69134a22-5293-4e3a-b0e1-3227b1b42818/search_products' \ -H 'X-API-Key: $PARSE_API_KEY'
Search Jumbo supermarket products by keyword. Supports pagination via offset, sorting, and filtering by facets such as brand, category, and promotions (aanbiedingen). Use filters parameter with format 'FacetKey:FacetValue' to filter results (e.g. 'Aanbiedingen:Alle aanbiedingen' for discounted products, 'Merken:Jumbo' for Jumbo brand products). Available facets and their values are returned in the response.
| Param | Type | Description |
|---|---|---|
| sort | string | Sort order. Accepts: 'rankA+desc' (popularity), 'price+asc' (price low to high), 'price+desc' (price high to low). Omitted returns default relevance order. |
| queryrequired | string | Search query term (e.g. 'melk', 'kaas', 'brood'). |
| offset | integer | Pagination offset. Each page returns ~24 products. |
| filters | string | Filter string in format 'FacetKey:FacetValue'. Use 'Aanbiedingen:Alle aanbiedingen' to show only promoted/discounted products. Use 'Merken:<brand>' to filter by brand. Available facets are returned in the response. |
{
"type": "object",
"fields": {
"facets": "array of available filter facets with their values and counts",
"header": "string - search result header text",
"offset": "integer - current pagination offset",
"products": "array of product objects with id, title, brand, price, promotions, etc.",
"total_count": "integer - total number of matching products",
"sort_options": "array of available sort options with text and value"
},
"sample": {
"data": {
"facets": [
{
"key": "category",
"name": "Categorieën",
"values": [
{
"id": "SG8",
"name": "Zuivel, boter en eieren",
"count": 20
}
]
}
],
"header": "Melk",
"offset": 0,
"products": [
{
"id": "293407DSL",
"link": "/producten/campina-langlekker-halfvolle-melk-12-x-1-l-293407DSL",
"brand": "Campina",
"image": "https://www.jumbo.com/dam-images/fit-in/360x360/Products/...",
"price": 21.65,
"title": "Campina Langlekker halfvolle melk 12 x 1 L",
"badges": [],
"category": "Zuivel, boter en eieren",
"subtitle": "12 x 1 liter",
"available": true,
"freshness": null,
"promotions": [
{
"id": "3017219",
"url": "/aanbiedingen/campina-optimel-en-vifit/3017219",
"tags": [
"10% korting",
"Alleen online"
],
"start": "wo 20 mei t/m di 16 jun"
}
],
"promo_price": 19.48,
"price_per_unit": {
"unit": "l",
"price": 1.62
}
}
],
"total_count": 31,
"sort_options": [
{
"text": "Populariteit",
"value": "rankA+desc"
},
{
"text": "Prijs (laag-hoog)",
"value": "price+asc"
}
]
},
"status": "success"
}
}About the jumbo.com API
The Jumbo.com API gives developers structured access to the Dutch supermarket's product catalog across 3 endpoints, returning fields like product price, brand, promotions, and facet filters. The search_products endpoint supports keyword queries with sorting, pagination, and facet-based filtering — including a dedicated promotion filter to surface current deals. Category browsing and autocomplete suggestions are also available.
Endpoints and What They Return
The search_products endpoint accepts a required query string and returns an array of product objects with fields including id, title, brand, price, and promotions. A total_count integer and offset field support paginated traversal of results — each page yields approximately 24 products. The facets array in the response lists available filter dimensions (brand, category, promotions) with per-value counts, so you can present dynamic filter UIs without a separate lookup call. The sort_options array tells you exactly which sort values the endpoint accepts at runtime.
Filtering and Sorting
Filters are passed as a single filters string using the format FacetKey:FacetValue. To restrict results to currently promoted products, pass Aanbiedingen:Alle aanbiedingen. The sort parameter accepts rankA+desc for popularity ordering, price+asc, and price+desc for price-based ordering. These can be combined with filters and offset for precise result slices.
Categories and Suggestions
get_categories returns the full Jumbo category tree as a nested array of objects, each carrying a title, link, and subcategories array. The optional depth parameter controls how many levels of the tree are returned. search_suggestions takes a partial query string and returns two separate arrays: keywords (suggested completions with query and display_text) and brands (brand-level matches that also include a link field). This makes it straightforward to build a typeahead that distinguishes between general keyword completion and direct brand navigation.
- Build a promotion tracker that polls
search_productswith theAanbiedingen:Alle aanbiedingenfilter to monitor current Jumbo deals - Power a price comparison tool using
price+ascsorting and brand facet filters from thefacetsresponse field - Render a full category navigation menu from the nested
subcategoriestree returned byget_categories - Implement a search typeahead that separates brand suggestions from keyword suggestions using the
brandsandkeywordsarrays fromsearch_suggestions - Paginate through an entire product category using
offsetto build a local product index for offline analysis - Filter results by a specific brand using
FacetKey:FacetValueformat and sort by price to find the cheapest items from that brand
| 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 Jumbo have an official public developer API?+
What product fields does `search_products` actually return for each item?+
products array includes at minimum id, title, brand, price, and promotions. The facets array returned alongside products lists filter dimensions with value counts, and sort_options shows available sort values. The exact depth of nested price and promotion objects reflects what Jumbo exposes on the product listing level.Does the API return individual product detail pages — ingredients, nutritional info, or images?+
How does pagination work in `search_products`?+
offset integer parameter. Each response returns approximately 24 products. Set offset to 24, 48, 72, etc. to walk through subsequent pages. The total_count field in the response tells you the full number of matching products so you can calculate how many pages exist.