products.checkers.co.za APIproducts.checkers.co.za ↗
Access Checkers South Africa product data via API: search, browse by category, get specials, and retrieve full product details including prices and promotions.
curl -X GET 'https://api.parse.bot/scraper/39122869-152e-40fc-908a-8756aa0ff69b/search_products?query=bread&page_size=2' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword with pagination. Returns comprehensive product data including name, price, description, images, barcodes, and promotion status.
| Param | Type | Description |
|---|---|---|
| page | integer | Zero-indexed page number |
| queryrequired | string | Search keyword |
| page_size | integer | Number of items per page |
{
"type": "object",
"fields": {
"products": "array of product objects with name, price, description, images, barcodes, promotion info, and slug",
"totalCount": "integer total number of matching products"
},
"sample": {
"data": {
"products": [
{
"id": "5db2b6a9280e5b57ebe9a222",
"name": "Darling Fresh Full Cream Milk Bottle 2L",
"slug": "darling-fresh-full-cream-milk-bottle-2l-10124887EA",
"price": 37.99,
"imageURL": "https://catalog.sixty60.co.za/files/69e7273d70515d47d2e26c8c",
"displayName": "Darling Fresh Full Cream Milk Bottle 2L",
"articleNumber": "10124887",
"isOnPromotion": false,
"unitOfMeasure": "EA",
"priceWithoutDecimal": 3799
}
],
"totalCount": 150
},
"status": "success"
}
}About the products.checkers.co.za API
This API covers 5 endpoints for querying the Checkers.co.za (Sixty60) product catalog, returning fields like name, price, description, images, barcodes, and promotion details. Use search_products to find items by keyword, get_specials to pull currently promoted products, or get_category_tree to navigate the full department hierarchy — all returning structured JSON you can integrate directly.
Search and Product Detail
The search_products endpoint accepts a required query string and optional page and page_size parameters (both zero-indexed) to paginate through results. Each product object in the products array includes the product name, price, description, images, barcodes, promotion status, and a slug field. That slug — formatted as name-articleNumber (e.g. clover-fresh-full-cream-milk-2l-10136729EA) — is the key input for get_product_details, which returns the full serverProduct object alongside serverBreadcrumbs for navigation context and a serverError boolean.
Category Browsing
get_category_tree returns the complete displayCategoryTree: a nested array of top-level departments, each with id, name, level, imageId, and nested displayCategories. Those category IDs feed directly into browse_category, which accepts a category_id string, plus optional page and page_size parameters, and returns a paginated list of products with the same field shape as search results — including totalCount so you can calculate page counts.
Specials and Promotions
get_specials returns products currently on promotion from Checkers' curated promotions page. The response includes the same core product fields plus bonusBuy details specific to promotional items, and a totalCount integer. This endpoint supports page and page_size for pagination, making it straightforward to retrieve the full promotions list in batches.
- Track price changes on specific Checkers products by polling
get_product_detailswith a product slug - Build a grocery comparison tool using
search_productsto retrieve current prices across items - Scrape the weekly promotions feed via
get_specialsto alert users to relevant deals - Map the full Checkers category hierarchy with
get_category_treefor building a navigation interface - Enumerate all products in a department using
browse_categorywith the category ID from the tree - Populate a product database with barcodes, descriptions, and images from
search_productsresults - Monitor
bonusBuypromotion details on featured items to track multi-buy discount structures
| 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 Checkers.co.za have an official developer API?+
What does `get_product_details` return beyond what `search_products` provides?+
get_product_details returns the full serverProduct object, which includes product attributes and display categories not present in search results. It also returns serverBreadcrumbs — an array of navigation objects showing where the product sits in the category hierarchy — and a serverError boolean. You need the product's slug from a search or browse response to call this endpoint.Does `get_specials` return all promotion types, including multi-buy and loyalty card deals?+
bonusBuy details for applicable items. It does not currently distinguish between loyalty-card-only pricing, Xtra Savings member deals, or other tiered promotion structures — all qualifying promotions appear in a single list. You can fork the API on Parse and revise it to add an endpoint targeting a specific promotion type.Is store-level inventory or stock availability included in the response?+
How does pagination work across these endpoints?+
search_products, browse_category, and get_specials endpoints all use a zero-indexed page parameter alongside page_size to control result windows. Each response includes a totalCount integer so you can calculate the total number of pages for a given query or category.