Co APIvictory.co.il ↗
Access Victory supermarket product catalog, pricing, stock status, categories, and active promotions via 4 structured API endpoints.
What is the Co API?
The Victory supermarket API provides 4 endpoints covering product search, individual product details, category hierarchy, and live promotions from victory.co.il. The search_products endpoint returns paginated results with pricing, stock availability, and category info across Hebrew and English queries. Product data includes barcodes, brand names, weight, and multiple image URLs, making it practical for price tracking, inventory monitoring, and grocery comparison tools.
curl -X GET 'https://api.parse.bot/scraper/48de4417-5d87-4207-a126-4555c8afd882/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 victory-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: Victory Grocery SDK — bounded, re-runnable; every call capped."""
from parse_apis.victory_co_il_api import Victory, ProductNotFound
client = Victory()
# Search for milk products — limit= caps TOTAL items fetched.
for product in client.products.search(query="חלב", limit=3):
print(product.name, product.price, product.in_stock)
# Drill-down: take one search result and fetch full details.
item = client.products.search(query="שוקולד", limit=1).first()
if item:
try:
full = item.details()
print(full.name, full.price, full.description[:80])
except ProductNotFound as e:
print("gone:", e.product_id)
# List all categories
for cat in client.categories.list(limit=3):
print(cat.name, len(cat.subcategories))
# List current promotions
for promo in client.promotions.list(limit=3):
print(promo.description, promo.regular_price, promo.sale_price)
print("exercised: products.search / ProductSummary.details / categories.list / promotions.list")
Full-text search over Victory's online product catalog. Returns paginated results with pricing, stock availability, and category info. Results are auto-iterated across pages.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination, 1-based. |
| queryrequired | string | Search query text in Hebrew or English (e.g. 'חלב' for milk). |
{
"type": "object",
"fields": {
"page": "current page number",
"total": "total number of matching products",
"products": "array of product summaries with id, name, price, stock status, image, and category",
"page_size": "number of results per page"
},
"sample": {
"data": {
"page": 1,
"total": 3064,
"products": [
{
"id": 19248434,
"name": "חלב נטול לקטוז מעושר בחלבוני חלב",
"brand": "מחלבת טרה",
"price": 14.3,
"weight": 1,
"barcode": null,
"category": "מוצרי קירור וביצים",
"in_stock": true,
"image_url": "https://d226b0iufwcjmj.cloudfront.net/gs1-products/1470/medium/7290114313865-992970/7290114313865/2025-06-18T22-51-10-885Z.jpg",
"sale_price": null,
"unit_price": null,
"weight_unit": "ליטר",
"has_promotion": false
}
],
"page_size": 20
},
"status": "success"
}
}About the Co API
Endpoints and Data Coverage
The search_products endpoint accepts a query string in Hebrew or English and an optional page number, returning an array of product summaries. Each result includes id, name, price, in_stock status, image, and category. The response also surfaces total and page_size so you can calculate pagination upfront and iterate across all matching results.
Product Detail and Category Data
Calling get_product with a numeric product_id (typically sourced from search results) returns the full product record: price in ILS, barcode (EAN), brand, weight, category, an images array with all available image URLs, and the in_stock flag. The get_categories endpoint requires no parameters and returns the complete category tree — top-level category objects each containing an id, name, and a nested subcategories array.
Promotions
The get_promotions endpoint returns all currently active deals without requiring any input parameters. Each promotion object includes regular and sale prices, a promotion description, associated product info, and validity dates. The total field in the response tells you how many active promotions are available at query time.
The Co API is a managed, monitored endpoint for victory.co.il — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when victory.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 victory.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?+
- Track price changes on specific Victory products by polling
get_productwith known product IDs - Build a Hebrew-language grocery search tool using
search_productswith Hebrew query strings - Monitor stock availability (
in_stockfield) across a list of products for inventory alerts - Aggregate current supermarket promotions and deal validity dates from
get_promotions - Map Victory's full product taxonomy by fetching the category tree from
get_categories - Compare regular vs. sale prices across promotion items using
get_promotionsresponse fields - Compile product barcodes and brand names for grocery database enrichment via
get_product
| 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.
Does Victory have an official public developer API?+
What does `get_product` return beyond the basic name and price?+
get_product returns the full product record including barcode (EAN), brand, weight, category, in_stock status, a price in ILS, and an images array containing all available product image URLs, in addition to the display name.How does pagination work in `search_products`?+
search_products endpoint is 1-based: pass page=1 for the first page. The response includes total and page_size, so you can compute the number of pages needed and iterate. Results are auto-iterated across pages when no page parameter is supplied.Does the API cover customer reviews or ratings for Victory products?+
Are promotions tied to specific categories or branches? Can I filter by store location?+
get_promotions returns sitewide active promotions with no filtering by category or store branch. Location- or branch-specific deals are not currently covered. You can fork this API on Parse and revise it to add branch-level filtering if that data is available.