Silpo APIsilpo.ua ↗
Access Silpo's full product catalog via API. Browse categories, search by keyword, and retrieve prices, ratings, stock status, and product URLs.
What is the Silpo API?
The Silpo API gives developers programmatic access to Ukraine's Silpo supermarket catalog through 3 endpoints, returning product titles, current prices, brand names, ratings, stock availability, and image URLs. Use get_products to page through category listings, search_products to query across all categories by keyword, or get_categories to retrieve the full navigable category tree with product counts and slugs.
curl -X GET 'https://api.parse.bot/scraper/b962038c-6239-49b5-a5e2-b171455797cf/get_categories?slug=frukty-ovochi-4788&depth=2' \ -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 silpo-ua-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: Silpo supermarket SDK — browse categories, list products, search by keyword."""
from parse_apis.silpo_supermarket_products_api import Silpo, Sort, SortDirection, InStock, CategoryNotFound
client = Silpo()
# Browse the top-level category tree (depth=1 for just top-level)
for cat in client.categories.list(depth=1, limit=5):
print(cat.slug, cat.total)
# List products in a specific category, sorted by price ascending
for product in client.products.list(category="frukty-ovochi-4788", sort_by=Sort.PRICE, sort_direction=SortDirection.ASC, limit=3):
print(product.title, product.price, product.brand)
# Search for products by keyword
first_product = client.products.search(query="молоко", sort_by=Sort.POPULARITY, limit=1).first()
if first_product:
print(first_product.title, first_product.price, first_product.in_stock, first_product.rating)
# Handle a category that doesn't exist
try:
results = client.products.list(category="nonexistent-category-99999", limit=1).first()
except CategoryNotFound as exc:
print(f"Category not found: {exc.slug}")
print("exercised: categories.list / products.list / products.search / CategoryNotFound error handling")
Get the category tree for Silpo store. Returns all product categories with their slugs and product counts. Use category slugs with get_products to browse products in a specific category. The depth parameter controls how many levels of subcategories are returned (1=top-level only, up to 7 for the full tree).
| Param | Type | Description |
|---|---|---|
| slug | string | Filter to a specific category branch by its slug (e.g. 'frukty-ovochi-4788') |
| depth | integer | Depth of category tree to return (1=top-level only, 7=full tree) |
{
"type": "object",
"fields": {
"items": "array of category objects with slug, children array, and total product count",
"total": "integer total number of top-level categories"
}
}About the Silpo API
Category Tree and Navigation
The get_categories endpoint returns the complete Silpo category hierarchy. Each category object includes a slug, child categories, and a total product count. The optional slug parameter scopes the response to a specific branch, and the depth parameter (1–7) controls how many levels of nesting are returned — useful for fetching only top-level categories or drilling into a specific subtree. Category slugs returned here (e.g. frukty-ovochi-4788, molochni-produkty-ta-iaitsia-234) are the same values accepted by get_products.
Browsing and Filtering Products
The get_products endpoint accepts a category slug or a search term and returns paginated product arrays. Each product object includes id, title, price, brand, rating, stock, image_url, and product_url. Results support sorting by popularity or price in either direction via sort_by and sort_direction, and can be filtered to in-stock items with in_stock=true. Pagination is controlled with limit (up to 100 per page) and a 0-based offset.
Keyword Search
The search_products endpoint accepts a required query string — Ukrainian-language terms like молоко or хліб work natively — and returns the same product shape as get_products, plus a query echo field confirming the term used. The same sort_by, sort_direction, limit, and offset parameters apply, making it straightforward to build paginated search result views.
The Silpo API is a managed, monitored endpoint for silpo.ua — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when silpo.ua 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 silpo.ua 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 for specific grocery items across Silpo's catalog over time using
search_products. - Build a Ukrainian grocery comparison tool by mapping products to categories via
get_categoriesslugs. - Monitor stock availability (
stockfield) for high-demand products in a specific category. - Generate a structured product feed by iterating through the full category tree with
get_categoriesand fetching each leaf node's products. - Power a recipe cost estimator by searching for ingredient keywords and retrieving current
pricevalues. - Filter in-stock products by price ascending to surface the cheapest available items in a given category.
- Aggregate brand presence data within a category using the
brandfield across paginatedget_productsresponses.
| 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 Silpo have an official public developer API?+
What product fields does `get_products` return, and can I filter by price range?+
id, title, price, brand, rating, stock, image_url, and product_url. Sorting by price (ascending or descending) is supported, but filtering by a min/max price range is not currently exposed. The API covers category and stock filtering plus popularity and price sorting. You can fork it on Parse and revise it to add a price range filter endpoint.Does `get_categories` return product counts for every category, including nested ones?+
get_categories response includes a total product count. You can control how deep the tree is returned using the depth parameter — set it to 1 for top-level categories only, or up to 7 for the full hierarchy. Scoping to a branch with the slug parameter limits both the depth traversal and the returned counts to that subtree.Does the API cover product reviews, nutritional information, or promotional offers?+
get_products and search_products endpoints. Detailed review text, nutritional labels, and promotional pricing data are not included. You can fork it on Parse and revise it to add an endpoint targeting those product detail fields.Does `search_products` support Ukrainian-language queries?+
query parameter accepts Ukrainian-language text natively, for example молоко (milk), хліб (bread), or сир (cheese). Results are returned in the same paginated product format as get_products, including the query echo field in the response.