Co APIpricez.co.il ↗
Search Israeli grocery and pharmacy products and retrieve per-store prices, stock status, and price ranges across retail chains via the PriceZ API.
What is the Co API?
The PriceZ API exposes 2 endpoints that cover Israeli grocery and pharmacy price comparison data from pricez.co.il. Use search_products to find items by Hebrew keyword and retrieve national price ranges, categories, and suppliers. Use get_product_prices to pull per-store pricing, unit prices, stock availability, and last-updated timestamps for any specific product ID across every Israeli retail chain carrying it.
curl -X GET 'https://api.parse.bot/scraper/c52b45a1-1869-4aa2-9c99-45313406b0c3/search_products?page=1&query=%D7%97%D7%9C%D7%91' \ -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 pricez-co-il-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: PriceZ SDK — bounded, re-runnable; every call capped."""
from parse_apis.pricez_co_il_api import PriceZ, ProductNotFound
client = PriceZ()
# Search for milk products, cap at 3 results
for product in client.products.search(query="חלב", limit=3):
print(product.name, product.price_min, product.price_max)
# Drill into the first result for per-store pricing
item = client.products.search(query="שוקולד", limit=1).first()
if item:
try:
detail = client.product_details.get(product_id=item.product_id)
print(detail.product_name, detail.category, detail.supplier)
for sp in detail.store_prices[:3]:
print(sp.store_name, sp.price, sp.in_stock)
except ProductNotFound as e:
print("not found:", e.product_id)
print("exercised: products.search, product_details.get")
Full-text search over PriceZ's grocery/pharmacy product catalog. Returns products matching the query with their national price range, category, and supplier. Results are paginated (53 per page); auto-iterated by the SDK.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for results pagination. |
| queryrequired | string | Search text in Hebrew or product name (e.g. חלב, שוקולד). |
{
"type": "object",
"fields": {
"page": "current page number",
"query": "search query echoed back",
"products": "array of product summaries with id, name, category, supplier, and price range",
"total_results": "total matching products across all pages"
},
"sample": {
"data": {
"page": 1,
"query": "חלב",
"products": [
{
"name": "חלב טרי 3% שומן בקרטון / בקבוק 1 ליטר(כללי)",
"category": "חלב טרי",
"supplier": "כללי",
"price_max": 7.35,
"price_min": 7.18,
"product_id": "89735"
}
],
"total_results": 3795
},
"status": "success"
}
}About the Co API
Search the Israeli Grocery Catalog
The search_products endpoint accepts a query string — in Hebrew or transliterated product name — and returns paginated results of 53 products per page. Each result includes a numeric id, the Hebrew name, category, supplier, and a national price range showing the lowest and highest prices found across all tracked stores. The total_results field tells you how many products matched, and the page parameter lets you iterate through all pages (the SDK auto-iterates).
Per-Store Pricing and Stock
Once you have a product ID from search_products, pass it to get_product_prices as the product_id parameter. The response includes the full Hebrew product_name, category, supplier, price_min and price_max in ILS at a national level, and a store_prices array. Each entry in that array represents one retail location and carries the store's current price, unit price, stock status, and the date the data was last updated.
Coverage and Data Shape
PriceZ tracks grocery and pharmacy chains across Israel. Prices are denominated in Israeli New Shekel (ILS). Product names and search queries are expected in Hebrew, so queries like חלב (milk) or שוקולד (chocolate) work as intended. The store_prices array size varies by product — high-volume staples appear in many chains; niche items may appear in fewer stores.
The Co API is a managed, monitored endpoint for pricez.co.il — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when pricez.co.il 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 pricez.co.il 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 price-comparison widget showing the cheapest and most expensive stores for a specific grocery item using
price_minandprice_max. - Monitor week-over-week price changes across Israeli retail chains by polling
get_product_pricesfor tracked product IDs. - Identify out-of-stock products at specific stores using the stock status field in
store_prices. - Aggregate category-level pricing trends by searching keywords and collecting price ranges from
search_productsresults. - Power a shopping basket optimizer that finds the lowest total cost across chains for a list of product IDs.
- Alert consumers when unit prices for a specific product drop below a threshold in any tracked store.
| 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 PriceZ have an official developer API?+
What does `get_product_prices` return beyond the national min/max price?+
price_min and price_max in ILS, the response includes the full Hebrew product_name, category, supplier, and a store_prices array. Each array entry covers one retail location with its current price, unit price, stock availability status, and the date that store's data was last updated.Can I filter `search_products` results by category or chain?+
search_products endpoint accepts a query string and an optional page number — there are no filter parameters for category, supplier, or chain. Each result does include category and supplier fields so you can filter client-side after retrieval. You can fork this API on Parse and revise it to add server-side category or chain filtering if needed.Does the API cover historical price data or only current prices?+
last_updated date per store entry. Historical price time-series are not currently exposed. The endpoints cover live pricing and stock status. You can fork the API on Parse and revise it to add a historical tracking endpoint if you need trend data.How does pagination work in `search_products`?+
total_results count and the current page number so you can calculate how many pages exist. The Parse SDK auto-iterates pages, but you can also pass the page parameter manually to fetch a specific page.