Co APIvictory.co.il ↗
Search and browse Victory supermarket's full product catalog, view detailed item information, explore product categories, and discover current promotions all in one place. Get instant access to pricing, availability, and special offers to find exactly what you need for your shopping.
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
The Co API on Parse exposes 4 endpoints for the publicly available data on victory.co.il. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.