Which stores does the Grocery API cover?
Live catalogue data for Pick n Pay (Claremont) and Checkers (Sixty60 Rondebosch). More stores and regions can be added for production plans.
storefront
Services
Grocery Data API
A single API key unlocks live prices, stock availability, promotions and side-by-side comparisons across Pick n Pay and Checkers — normalized, structured, and ready for your app, agent, or price-comparison tool.
Developer quickstart
Live in three lines
Every request is authenticated with a standard bearer key from your dashboard — the same keys the AI Gateway uses. No SDK, no setup, no card.
GET
/api/v1/grocery/search?q={query}&store={pnp|checkers|all}Live catalogue search with prices, stock flags and promotions.
GET
/api/v1/grocery/compare?q={query}&limit={n}Size-normalized side-by-side comparison with cheapest-store detection.
curl "https://azlabs.ai/api/v1/grocery/compare?q=bread&limit=3" \
-H "Authorization: Bearer sk-azl-live-..."Response
{
"query": "bread",
"matches": [
{
"size": "700g",
"name": "Albany Superior White Sliced Bread 700g",
"cheapestStores": ["checkers"],
"saving": 1.0,
"offers": [
{ "store": "pnp", "name": "Albany Superior White Sliced Bread 700g", "price": 18.99, "inStock": true },
{ "store": "checkers", "name": "Albany Superior White Sliced Bread 700g", "price": 17.99, "inStock": true }
]
}
]
}Overview
What is Grocery Data API?
A single API key unlocks live prices, stock availability, promotions and side-by-side comparisons across Pick n Pay and Checkers — normalized, structured, and ready for your app, agent, or price-comparison tool. Our team works with you to map the highest-value workflow, shape the business rules, connect the right systems, and launch a solution that can be measured against real outcomes from day one.
schedule
24/7 Availability
Always-on service
savings
90% Cost Reduction
Compared to manual
rocket_launch
Setup in 2 Weeks
Rapid deployment
Commercial outcomes
What this usually improves
2 live
Stores covered
JSON
Response format
One key
Auth
South Africa
Built for South African operations
ZAR pricing and South African stores — no international data that does not apply locally.
Built on the same infrastructure as the AI Gateway, with local support in SA business hours.
Ideal for SA developers building price-comparison tools, budget apps, or shopping agents for the local market.
Capabilities
Key capabilities
storefront
Two Stores, One Query
Search across Pick n Pay and Checkers with a single request. Compare endpoints pair matching products by size and return the cheapest store automatically.
currency_exchange
Live ZAR Pricing
Current shelf prices, promotions, and pre-promotion reference prices in South African Rand, refreshed from the live storefront catalogues.
inventory_2
Stock Awareness
Every product carries an in-stock flag so your price comparison never recommends something the store cannot deliver.
straighten
Size-Normalized Matching
“0.5L” and “500ml” are the same product. Packs are matched by count and weight so you compare like with like, not label with label.
key
One Key, Same Dashboard
Uses the same sk-azl-live- API keys as the AI Gateway. Generate a key from your dashboard and point any HTTP client at the endpoint.
code
Plain REST + JSON
No SDK required. GET endpoints return clean JSON you can consume from any language, including AI agents and serverless functions.
Applications
Use cases
compare_arrows
Price Comparison Apps
Build a shopping app or site that shows users which store has the best price for every item, with live stock confidence.
smart_toy
AI Shopping Agents
Give an agent a tool that checks real prices before it answers “where should I buy this?” — grounded in live data, not guesses.
bar_chart
Market & Spend Research
Track catalogue prices over time for budgeting tools, inflation analysis, or internal purchasing decisions.
Integrations
Common system touchpoints
cURLPythonNode.jsOpenAI SDK toolsAny HTTP client
Our Process
How it works
forum1
Consultation
Understand your goals and requirements
design_services2
Design
Architect the optimal solution
code3
Development
Build and test your AI solution
rocket_launch4
Launch
Deploy, monitor, and optimize
Frequently asked questions
Is this real-time data?
Each request queries the live storefront catalogues at call time. Prices, promotions and stock reflect what the stores are showing right now.
How is this different from Open Food Facts?
Open Food Facts is free but covers barcode nutrition data with crowd-submitted prices. This API delivers verified live ZAR shelf prices, stock flags and promotions for two South African stores, with size-normalized comparison.
Do I need a card to try it?
No. The free tier includes a daily request allowance per key with no card required, and the same dashboard you already use for the AI Gateway.
Can I use it from an AI agent?
Yes. The endpoints return plain JSON and can be registered as a tool in OpenAI-compatible tool calling, LangChain, or any agent framework.
Ready to get started?
Book a free consultation to discuss how grocery data api can transform your business operations.