Jumbo Dashboard

– Items

– Total

– My Lists

– Total Products

– Total Orders

– Store Receipts

Online Orders

Store Receipts

No receipts

Add Product

Remove Product

Barcode Lookup

Search by SKU

No commands yet

API Documentation

Welcome to the Jumbo API. This API provides programmatic access to your Jumbo.com shopping basket, lists (lijstjes), product search, and more.

Interactive API Explorer

Try all endpoints directly in your browser with the Swagger UI. No code required – perfect for testing and learning the API.

Swagger/OpenAPI

API Reference

Complete API documentation with examples, authentication guides, and integration patterns.

README.md

🚀 Quick Start

Authenticate using POST /api/login or load saved cookies
Explore endpoints in the Swagger UI
View your basket with GET /api/basket
Search products, manage lists, and more!

📚 Key Features

🛒 Basket Management

View, add, remove, and update quantities in your shopping basket

📝 Shopping Lists

Access all your lijstjes (shopping lists) with full product details

🔍 Product Search

Search by SKU or barcode to find products instantly

🔐 Secure Auth

Automated Selenium-based login with cookie persistence

🔐 Login Credentials

Save your Jumbo.com credentials for automatic re-authentication when sessions expire.

Email Address Your Jumbo.com account email

Password Your Jumbo.com account password

No credentials saved Credentials are stored locally in a secure Docker volume

🔍 Barcode Lookup

Configure how barcodes are looked up and matched when scanning EAN codes.

OpenFoodFacts Fallback If barcode not found in Jumbo, query OpenFoodFacts and search by product name

Max Product Candidates Number of products to check for EAN similarity (5-50, higher = more accurate but slower)

Include Size/Volume in Search Add quantity to search (e.g., "Cola 1,5 l" vs "Cola") - helps find single items vs multi-packs

Include Brand in Search Add brand to search (e.g., "Jumbo Cola" vs "Cola") - helps with brand-specific products

🎯 EAN Matching Scores

Configure scoring thresholds for EAN barcode similarity matching (0-100 points).

10+ Matching Digits Score for 10 or more matching digits (e.g., 8718452829xxx)

8-9 Matching Digits Score for 8-9 matching digits (medium confidence)

6-7 Matching Digits Score for 6-7 matching digits (low confidence)

4-5 Matching Digits Score for 4-5 matching digits (very low confidence)

🧾 Receipt Product Matching

Control how store receipt items are matched to catalog products.

Enable Product Matching Search and match receipt items to Jumbo catalog products with images and details

Strict Matching Only show matches with high confidence (≥70%) to prevent wrong products

Confidence Threshold Minimum confidence score (0-100) required to show a product match

⚖️ Matching Weights

Adjust how much each factor contributes to the match score (0-100 points each).

Enable Price Matching Compare receipt price against catalog price

Price Weight Maximum points awarded for price match (default: 40)

Enable Weight/Volume Matching Compare grams, millilitres, and litres from receipt

Weight/Volume Weight Maximum points awarded for weight/volume match (default: 30)

Enable Name Matching Compare product name words for overlap

Name Weight Maximum points awarded for name similarity (default: 30)

💾 Cache Settings

Control caching behavior for faster lookups and consistent results.

Enable Barcode Cache Cache barcode lookups to avoid repeated searches - disable for always-fresh results

Clear Match Cache Remove all cached results - items will be re-matched on next view