woolworths.co.za APIwoolworths.co.za ↗
Access Woolworths SA food categories, product listings, nutritional data, pricing, and store locations via a structured API. 7 endpoints covering search and store locator.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/3c08f360-415f-4984-bcd1-846bc0d7dafc/get_food_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Get the top-level food categories and their URLs from the Woolworths food department page. Returns category names and URL paths that can be used with get_product_listing.
No input parameters required.
{
"type": "object",
"fields": {
"data": "array of category objects with name and url",
"status": "string indicating success"
},
"sample": {
"data": [
{
"url": "/cat/Food/Fruit-Vegetables-Salads/_/N-lllnam",
"name": "fruit veg salad"
},
{
"url": "/cat/Food/Meat-Poultry-Fish/_/N-d87rb7",
"name": "meat poultry fish"
}
],
"status": "success"
}
}About the woolworths.co.za API
This API exposes 7 endpoints covering Woolworths South Africa's food catalogue and store network. You can retrieve top-level food categories via get_food_categories, paginate through product listings with pricing, search by keyword, and pull full product detail records including ingredients, allergens, nutritional information, and images. Three store locator endpoints let you resolve provinces, suburbs, and nearby store addresses.
Food Catalogue Endpoints
get_food_categories returns an array of category objects, each with a name and url field. Those URL paths feed directly into get_product_listing as the required category_url parameter. get_product_listing returns a products array plus a total count, paginated in pages of 24 — use the offset integer parameter to walk through results. search_products accepts a query string and the same offset parameter, returning matching products with prices. Note that some search terms may return zero results if they do not match indexed product names on the site.
Product Detail
get_product_details takes a product_url path from any listing or search result and returns a structured object covering id, name, description, brand, images, ingredients, nutritional_info, allergens, dietary_info, and pricing. This is the endpoint to use when you need label-level data — macronutrient breakdowns, allergen flags, and dietary classifications — rather than just the summary price and name available in listing results.
Store Locator
Three endpoints cover physical store discovery. get_store_locator_provinces returns all South African provinces with storePickupEnabled and liquorDeliveryEnabled boolean flags per province. get_store_locator_suburbs returns a flat list of suburbs with name, id, and postalCode fields. Pass a suburb_id from that list into get_stores_by_suburb along with an optional distance radius (in km) to get nearby stores with name, address, and phone fields.
- Build a South African grocery price tracker using product listings and pricing fields from get_product_listing.
- Extract allergen and ingredient data from get_product_details to power a dietary restriction filtering tool.
- Aggregate nutritional_info fields across product categories for meal planning or calorie tracking applications.
- Map Woolworths store locations by suburb using get_stores_by_suburb with distance radius filtering.
- Check province-level liquorDeliveryEnabled flags to determine delivery eligibility for alcohol products.
- Sync Woolworths food catalogue data into a comparison shopping platform using search_products with paginated offsets.
- Monitor price changes on specific products by polling get_product_details with known product URL paths.
| 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 Woolworths South Africa have an official developer API?+
What product-level fields does get_product_details return beyond basic pricing?+
ingredients, nutritional_info, allergens, dietary_info, images, brand, and description in addition to price and product identifiers. This makes it the appropriate endpoint when you need label-quality data rather than just the name and price surfaced in listing results.Does the API cover non-food departments like clothing or homeware?+
Does get_product_listing support filtering by dietary flag or price range within a category?+
category_url and offset as inputs; there is no server-side filter for dietary flags or price range. Filtering on those fields would need to be done client-side against the returned products array. You can fork this API on Parse and revise it to expose additional filter parameters if the underlying category pages support them.How does pagination work across listing and search endpoints?+
total count so you can calculate how many pages exist. Pass multiples of 24 (0, 24, 48, ...) as the offset integer to retrieve subsequent pages.