Sous Chef APIsouschef.co.uk ↗
Search the Sous Chef online store catalogue by keyword. Returns product name, brand, SKU, price, star rating, and URL for each matching result.
What is the Sous Chef API?
The Sous Chef API gives programmatic access to the souschef.co.uk product catalogue through a single search_products endpoint, returning up to 8 fields per product including name, brand, SKU, price, formatted price, average star rating, and product URL. Results are paginated in pages of 20, with total_results and has_more fields to drive full catalogue traversal. The API covers the full range of specialty food products stocked by Sous Chef.
curl -X GET 'https://api.parse.bot/scraper/13312c41-eccd-440a-9ea0-2905037cb80a/search_products?query=soy+sauce' \ -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 souschef-co-uk-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: Sous Chef UK product search — bounded, re-runnable."""
from parse_apis.souschef_co_uk_api import SousChef, InvalidInput
client = SousChef()
# Search for soy sauce products, capped at 5 total items.
for product in client.products.search(query="soy sauce", limit=5):
print(f"{product.name} ({product.brand}) — {product.price_display}")
# Drill into the first result of a different search.
hit = client.products.search(query="truffle oil", limit=1).first()
if hit is not None:
print(f"{hit.name} SKU={hit.sku} rating={hit.rating} from={hit.price_is_from}")
print(f" {hit.url}")
# Handle invalid input (e.g. page out of range).
try:
client.products.search(query="knife", limit=1).first()
except InvalidInput as e:
print(f"Invalid input: {e.message}")
print("exercised: products.search / InvalidInput")
Searches the Sous Chef store catalogue by free-text keywords and returns one row per matching product, in the store's own relevance order. Results are paginated in fixed pages of 20 products; the optional page input selects the page (omitted = first page) and the response reports total_results, total_pages and has_more so a caller can continue. Each call costs one request. price is the numeric price in the store's active currency (currency field, observed GBP); when price_is_from is true the product has several variants and price is the lowest variant price. rating is the store's average star rating out of 5 (0.0 when the product has no reviews yet, null when the store publishes no rating for it); a review count is not available from search results. A query with no matches returns an empty products array with total_results 0. A non-positive page is rejected as invalid input.
| Param | Type | Description |
|---|---|---|
| page | integer | 1-based results page number; each page holds up to 20 products. |
| queryrequired | string | Free-text search keywords, e.g. one shape is a product type such as a sauce name. |
{
"type": "object",
"fields": {
"page": "integer, the page returned",
"query": "the search keywords as submitted",
"has_more": "boolean, true when a later page exists",
"products": "array of product rows: product_id (string store id), name, brand, sku, price (number), price_display (formatted with currency symbol), price_is_from (boolean, lowest variant price), currency (ISO code), rating (number 0-5 or null), url (product page)",
"page_size": "integer, maximum products per page (20)",
"total_pages": "integer, derived from total_results and page_size",
"total_results": "integer, total matching products reported by the store"
},
"sample": {
"data": {
"page": 1,
"query": "soy sauce",
"has_more": true,
"products": [
{
"sku": "JP0093",
"url": "https://www.souschef.co.uk/products/kikkoman-soy-sauce-1l",
"name": "Kikkoman Soy Sauce 1l",
"brand": "Kikkoman",
"price": 6.8,
"rating": 5,
"currency": "GBP",
"product_id": "1770957930554",
"price_display": "£6.80",
"price_is_from": false
},
{
"sku": "SE0021B",
"url": "https://www.souschef.co.uk/products/soy-sauce-dark",
"name": "Dark Soy Sauce",
"brand": "Pearl River Bridge",
"price": 3,
"rating": 4.8,
"currency": "GBP",
"product_id": "1770501799994",
"price_display": "£3.00",
"price_is_from": true
}
],
"page_size": 20,
"total_pages": 36,
"total_results": 706
},
"status": "success"
}
}About the Sous Chef API
What the API Returns
The search_products endpoint accepts a free-text query string and returns a ranked list of matching products from the Sous Chef catalogue. Each product row includes product_id, name, brand, sku, price (numeric), price_display (currency-formatted string), and avg_rating (average star rating). The response also carries pagination metadata: page, page_size (fixed at 20), total_results, total_pages, and has_more.
Pagination and Coverage
Results are returned in the store's own relevance order. The optional page input is 1-based; omitting it returns the first page. Use has_more to determine whether additional pages exist, and total_pages to calculate how many requests a full traversal requires. total_results reflects what the store reports for the query, so it can vary between queries and over time as the catalogue changes.
Query Flexibility
The query parameter accepts any free-text keyword — product type, ingredient, brand name, cuisine, or dish style. There are no built-in filters for category, brand, or price range at the parameter level; all filtering must be done on the client side using the fields returned in the product rows.
The Sous Chef API is a managed, monitored endpoint for souschef.co.uk — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when souschef.co.uk 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 souschef.co.uk 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?+
- Track price changes on specialty condiments and sauces across the Sous Chef catalogue
- Build a product comparison tool using brand, SKU, and price fields from search results
- Aggregate average star ratings across a category to surface top-rated specialty ingredients
- Monitor which products appear for a given keyword to study catalogue relevance ordering
- Compile a full list of products by a specific brand using the brand field in results
- Feed a recipe site with matching ingredient purchase links using product URLs from results
- Detect when new products matching a keyword enter the Sous Chef catalogue via total_results changes
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.