Jumbo APIjumbo.cl ↗
Search the Jumbo.cl grocery catalog and retrieve product details: EAN barcodes, nutritional tables, ingredients, prices in CLP, and presentation specs.
What is the Jumbo API?
The Jumbo.cl API covers Chile's largest supermarket chain through 2 endpoints, giving you catalog search across 40-product pages and full per-product detail including nutritional tables, ingredients, EAN barcodes, and presentation attributes. The get_product endpoint returns over a dozen structured fields — from ean and fact_sheet rows to a nutrition.table array with per-100g and per-portion breakdowns — making it practical for food databases, price trackers, and compliance tools.
curl -X GET 'https://api.parse.bot/scraper/1c659475-72cc-4a7a-9835-1dc650b4a5c7/search_products?query=leche' \ -H 'X-API-Key: $PARSE_API_KEY'
Searches the Jumbo.cl catalog by free-text term and returns one page of product summaries (40 products per page, ordered by the site's default relevance). Each item carries the site's identifiers (product_id, sku_id, reference — the 'Código' shown on the product page) and the slug that get_product accepts unchanged. total_count is the site's reported number of matching products; has_more is true while page*40 < total_count. Pagination is controlled by the optional page input (1-based; omitted = first page). Prices are integer Chilean pesos (CLP); unit_price is the price per unit_price_measurement_unit. The site returns fallback suggestions rather than an empty list for terms with no exact match, so a non-empty result does not guarantee the term matched.
| Param | Type | Description |
|---|---|---|
| page | integer | 1-based result page; each page holds up to 40 products. |
| queryrequired | string | Free-text search term (product name, brand or category), e.g. a product word in Spanish. |
{
"type": "object",
"fields": {
"page": "integer, page returned",
"items": "array of product summaries: product_id, sku_id, reference, slug (input for get_product), name, brand, price and list_price (CLP integers), unit_price with unit_price_measurement_unit, measurement_unit, in_stock, sold_by, image, url",
"query": "echo of the search term",
"has_more": "boolean, whether a further page exists",
"page_size": "integer, products per page (40)",
"total_count": "integer, site-reported total matching products"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"url": "https://www.jumbo.cl/leche-entera-surlat-b-a-1l-1991554/p",
"name": "Leche Surlat Entera 1 L",
"slug": "leche-entera-surlat-b-a-1l-1991554",
"brand": "Surlat",
"image": "https://jumbocl.vteximg.com.br/arquivos/ids/638741-250-250/Leche-Surlat-Entera-1-L.jpg?v=639142034095700000",
"price": 1100,
"sku_id": "134758",
"sold_by": "Jumbo",
"in_stock": true,
"reference": "1991554",
"list_price": 1100,
"product_id": "134465",
"unit_price": 1100,
"measurement_unit": "un",
"unit_price_measurement_unit": "lt"
}
],
"query": "leche",
"has_more": true,
"page_size": 40,
"total_count": 371
},
"status": "success"
}
}About the Jumbo API
Catalog Search
The search_products endpoint accepts a free-text query (product name, brand, or category keyword in Spanish) and an optional 1-based page parameter. Each page returns up to 40 product summaries. The response includes total_count (site-reported matches), has_more to drive pagination, and per-item fields: product_id, sku_id, reference (the "Código" shown on the product page), slug (needed as input to get_product), name, brand, price, and list_price — both in Chilean pesos (CLP integers).
Per-Product Detail
get_product takes a slug from search results and returns the full product record. Identifiers include product_id, sku_id, reference, and ean (EAN/GTIN barcode, null when not published by the retailer). Pricing fields are price, list_price, and unit_price with its unit_price_measurement_unit. The images array contains all product image URLs the site publishes.
Nutritional and Ingredient Data
The nutrition object includes portion, portions_per_container (both nullable strings), labeling flags, and a table array where each entry has nutrient, per_100g_ml, and per_portion with value and unit sub-fields. The ingredients field is an array of ingredient strings, empty when the retailer does not publish them. These two fields make the endpoint particularly useful for food-compliance and dietary-analysis workflows.
Presentation and Specifications
The fact_sheet array contains every specification row the site lists for a product — key/value pairs covering attributes such as pack size, net content, container type, format, flavor, and country of origin. This structured data is available directly without parsing free-text descriptions.
The Jumbo API is a managed, monitored endpoint for jumbo.cl — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when jumbo.cl 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 jumbo.cl 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 CLP price tracker that monitors
pricevslist_priceacross product categories over time. - Populate a Chilean food database with EAN barcodes, ingredient lists, and nutritional tables from
get_product. - Aggregate
fact_sheetpresentation attributes (net content, container, format) for product catalog normalization. - Run dietary or allergen screening by parsing the
ingredientsarray andnutrition.tableacross multiple SKUs. - Compare Jumbo.cl shelf prices against other Chilean retailers using
unit_priceandunit_price_measurement_unit. - Generate product data sheets for regulatory or e-commerce use from
ean,reference,nutrition, andfact_sheet. - Paginate through
search_productswithhas_moreto build a local index of all products in a category.
| 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 Jumbo.cl offer an official developer API?+
What does `get_product` return for nutritional data, and when is it missing?+
nutrition object includes a table array with nutrient, per_100g_ml, and per_portion rows, plus portion and portions_per_container strings and labeling flags. The ingredients field is an array of strings. Both are empty or null when the retailer has not published that information for the specific product — this is common for non-food items and some private-label products.Does the API cover product reviews or seller ratings for Jumbo.cl listings?+
How does pagination work in `search_products`, and is there a limit on results?+
page parameter is 1-based, and each page returns up to 40 products (page_size: 40). The total_count field gives the site-reported match count, and has_more indicates whether another page exists. You iterate by incrementing page until has_more is false.Does the API return stock availability or inventory status for products?+
price, list_price, unit_price) and product metadata, but does not expose stock level or in-stock/out-of-stock status. You can fork it on Parse and revise to add availability signals if the retailer surfaces them on product pages.