Kosher SA APIkoshersa.co.za ↗
Access the Kosher SA certified product database via API. Search by product name and retrieve certification details including kosher type, status, manufacturer, and category.
What is the Kosher SA API?
The Kosher SA API provides access to a certified product database covering kosher-certified goods available in South Africa. A single endpoint, search_products, returns up to 8 structured fields per product — including kosher type classification, certification status, manufacturer, category, and notes — with full pagination support and an empty-query mode that retrieves the entire database.
curl -X GET 'https://api.parse.bot/scraper/7efaa0d7-1051-461b-bc12-2b98713a0075/search_products?page=1&query=milk&per_page=50' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace koshersa-co-za-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Kosher SA SDK — bounded, re-runnable; every call capped."""
from parse_apis.Kosher_SA_Product_Database_API import KosherSA, ParseError
client = KosherSA()
# Search for dairy products containing "milk"
for product in client.products.search(query="milk", limit=3):
print(product.product, "|", product.manufacturer, "|", product.type)
# Get the first result and inspect all fields
item = client.products.search(query="chocolate", per_page=50, limit=1).first()
if item:
print(item.product, item.category, item.kosher_status, item.international_product)
# Handle errors gracefully
try:
for p in client.products.search(query="honey", limit=2):
print(p.product, p.manufacturer, p.notes)
except ParseError as e:
print(f"error: {e}")
print("exercised: products.search")
Search the Kosher SA product database by product name. Returns paginated results with full certification details including manufacturer, category, kosher type classification, kosher status, international product flag, and notes. An empty query returns all products in the database. Results are auto-iterated across pages; the page size is configurable (50, 100, 150, or 200 products per page).
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| query | string | Product name search term. Matches against product names. Empty string returns all products. |
| per_page | integer | Number of products per page. Accepted values: 50, 100, 150, 200. |
{
"type": "object",
"fields": {
"page": "current page number",
"products": "array of product objects with certification details",
"total_pages": "total number of available pages",
"results_count": "number of products on the current page"
},
"sample": {
"data": {
"page": 1,
"products": [
{
"type": "Dairy",
"notes": "",
"product": "1701 FRENCH MILK CHOCOLATE (85G)",
"category": "SWEETS & CHOCOLATES",
"manufacturer": "1701 NOUGAT",
"kosher_status": "Kosher",
"international_product": "No"
}
],
"total_pages": 19,
"results_count": 50
},
"status": "success"
}
}About the Kosher SA API
What the API Returns
The search_products endpoint queries the Kosher SA product registry and returns paginated arrays of product objects. Each object carries: product name, manufacturer, product category, kosher type classification (e.g. Kosher, Kosher Pareve, Kosher Dairy), kosher status, a boolean-style flag indicating whether the product is internationally sourced, and any certification notes. Pagination metadata accompanies every response: page, total_pages, and results_count.
Querying and Pagination
The query parameter accepts a product name string and performs a name-match search. Passing an empty string for query returns all products in the database, which is useful for bulk ingestion or building a local mirror. The page integer parameter steps through result pages. Both parameters are optional — calling the endpoint with no parameters returns the first page of all products.
Data Scope and Freshness
Coverage is limited to products certified by Kosher SA, the South African kosher certification authority. The database reflects certifications current at the time of retrieval. Products are categorised by type and carry a flag distinguishing South African products from internationally sourced ones, which is relevant for import-aware use cases such as retail shelf management or dietary compliance tooling.
The Kosher SA API is a managed, monitored endpoint for koshersa.co.za — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when koshersa.co.za 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 koshersa.co.za 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 kosher product lookup tool filtered by kosher type (Pareve, Dairy, Meat) for South African consumers
- Export the full certified product list by querying with an empty string and iterating all pages
- Cross-reference manufacturer names against retail inventory to verify kosher certification status
- Flag internationally sourced products in a grocery management system using the international product field
- Populate a dietary compliance checklist app with live kosher status and certification notes
- Identify products in a specific category to build category-filtered kosher shopping lists
| 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 | 100 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 Kosher SA provide an official developer API?+
What does the kosher type classification field contain, and how does it differ from kosher status?+
products array.Does the API support filtering by category, manufacturer, or kosher type directly?+
search_products endpoint currently accepts only a query parameter that matches against product names. Filtering by category, manufacturer, or kosher type is not a native parameter. You can retrieve the full database with an empty query and apply client-side filtering, or fork this API on Parse and revise it to add dedicated filter parameters for those fields.Is data available for products certified by authorities other than Kosher SA?+
How should I retrieve all products in the database, and how do I know when I've reached the last page?+
search_products with an empty query and page=1. The response includes total_pages; keep incrementing the page parameter until it equals total_pages. The results_count field on each response confirms how many products are on that page, which may be fewer on the final page.