silpo.ua APIsilpo.ua ↗
Access Silpo's full product catalog via API. Browse categories, search by keyword, and retrieve prices, ratings, stock status, and product URLs.
curl -X GET 'https://api.parse.bot/scraper/b962038c-6239-49b5-a5e2-b171455797cf/get_categories?depth=1' \ -H 'X-API-Key: $PARSE_API_KEY'
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.
| 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, and total product count",
"total": "integer total number of top-level categories"
},
"sample": {
"data": {
"items": [
{
"slug": "frukty-ovochi-4788",
"total": 4263,
"children": []
},
{
"slug": "molochni-produkty-ta-iaitsia-234",
"total": 2966,
"children": []
}
],
"total": 28
},
"status": "success"
}
}About the silpo.ua 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.
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.
- 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 | 250 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.