catalog.onliner.by APIcatalog.onliner.by ↗
Access Onliner.by product data via API: search products, get offers from multiple shops, price history, reviews, and category listings.
curl -X GET 'https://api.parse.bot/scraper/3ea1bc18-1b5b-49a5-b64f-6604a5b44569/search_products?page=1&limit=10&query=iphone' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products in the Onliner.by catalog by keyword query. Returns paginated results sorted by relevance.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search query string (e.g. 'iphone', 'samsung galaxy'). |
{
"type": "object",
"fields": {
"page": "object with pagination info: limit, items, current, last",
"total": "integer total number of matching products",
"products": "array of product objects with id, key, name, full_name, prices, reviews, description, images, and more"
},
"sample": {
"data": {
"page": {
"last": 100,
"items": 10,
"limit": 10,
"current": 1
},
"total": 16015,
"products": [
{
"id": 4943088,
"key": "iphone17256bk",
"name": "iPhone 17 256GB (черный)",
"prices": {
"offers": {
"count": 51
},
"price_max": {
"amount": "3760.15",
"currency": "BYN"
},
"price_min": {
"amount": "2700.00",
"currency": "BYN"
}
},
"status": "active",
"reviews": {
"count": 25,
"rating": 44
},
"full_name": "Apple iPhone 17 256GB (черный)"
}
]
},
"status": "success"
}
}About the catalog.onliner.by API
The Onliner.by Catalog API covers 7 endpoints for querying Belarus's largest product catalog, returning structured product data including prices, shop offers, user reviews, and historical price trends. The search_products endpoint accepts a keyword query and returns paginated results with per-product price ranges, review summaries, and full specifications. Use get_product_price_history to retrieve daily minimum prices across 2-month or 12-month windows.
Product Search and Lookup
The search_products endpoint accepts a query string (for example, 'iphone' or 'samsung galaxy') and an optional page integer for pagination. Each result in the products array includes a unique key field — used as the primary identifier across all other endpoints — along with name, full_name, prices (containing price_min and price_max), reviews (rating and count), and a description string. The page object in the response carries limit, items, current, and last for navigating large result sets. The search_autocomplete endpoint serves the same purpose for partial queries, returning a lighter product array suitable for suggestion UIs.
Product Details and Offers
get_product returns the full record for a single item identified by product_key, including a manufacturer object with name and legal info, a status string, and the prices and reviews summaries. To retrieve per-shop pricing, use get_product_offers: the response contains a shops map (keyed by shop_id) with each shop's title, logo, work hours, and physical addresses, alongside a positions.primary array that lists individual offers with price, warranty terms, delivery info, and stock status.
Reviews and Price History
get_product_reviews returns paginated user reviews for a product. Each review object includes rating, summary, text, pros, cons, author, and created_at. The page object follows the same pagination shape as search results. get_product_price_history accepts an optional period parameter — either '2m' or '12m' — and returns a chart_data object with a currency field and an items array of date/price pairs, plus a prices summary with current, min, and max values.
Category Browsing
get_category_products lists products within a named category using a category_key string such as 'mobile', 'notebook', or 'tv'. Results are sorted by popularity within the category and follow the same paginated product array structure as the search endpoint.
- Track daily minimum prices for electronics using
get_product_price_historychart_data items over a 12-month window - Build a price comparison tool by aggregating shop offers from
get_product_offerspositions.primary across multiple products - Populate a product search autocomplete widget using
search_autocompletefor partial query strings - Scrape review sentiment by extracting
pros,cons, andratingfields fromget_product_reviews - Monitor stock status changes for specific products by polling
get_product_offerspositions stock_status field - Generate category-level product feeds using
get_category_productswith category keys like 'tv' or 'notebook' - Enrich product listings with manufacturer legal info and full specifications via
get_productmanufacturer and description fields
| 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 Onliner.by have an official public developer API?+
What does `get_product_offers` return beyond just a price?+
positions.primary array where each offer includes the shop's price, warranty terms, delivery details, and stock status. The shops map provides corresponding shop metadata: title, logo, physical addresses, work hours, and review data for each seller.What time periods are supported for price history?+
get_product_price_history endpoint accepts a period parameter with two accepted values: '2m' for a two-month window and '12m' for a twelve-month window. Each period returns daily price points as date/price pairs in the chart_data.items array, along with current, minimum, and maximum price summaries.Does the API cover seller ratings or shop review counts?+
get_product_offers includes a reviews field for each shop in the shops map, but detailed individual shop reviews or seller reputation breakdowns are not a dedicated endpoint. The API covers product-level reviews via get_product_reviews and shop summary data within offer results. You can fork this API on Parse and revise it to add a dedicated shop reviews endpoint.Can I filter search results by price range, brand, or other attributes?+
search_products endpoint accepts a query string and a page integer for pagination; there are no filter parameters for price range, brand, or category in the current specification. The API covers keyword search and category browsing via get_category_products. You can fork this API on Parse and revise it to add attribute-based filtering endpoints.