Pazaruvaj
Bulgaria's price comparison: every shop's price in euro and lev with shipping and stock, specs, price history and category listings.
/pazaruvaj/v1/search3 creditsKeyword search across the whole pazaruvaj.com catalogue (Bulgaria). Each row is a compared product with its lowest price in EUR as the site prints it ('от 512,12 €'), the lowest and highest price in lev from the page data (`price_from_bgn`, `price_max_bgn`), the number of shop offers, rating, review count, brand and category, or (`row_type: shop_offer`) a single shop's item. Optional price range in EUR and sort; 20 rows per page, at most 100 pages (the site's own pager).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Search words (Bulgarian, Latin product names or brands, e.g. `iphone 15`, `пералня`, `samsung galaxy`). |
| min_price | optional | 0– | Lowest 'from' price, in EUR. |
| max_price | optional | 0– | Highest 'from' price, in EUR. |
| sort = relevance | optional | relevance · popular · price_asc · price_desc · rating · name | Result order. |
| page = 1 | optional | 1–100 | Result page. Search: 20 per page, at most 100 pages (the site's own pager limit). Category: 25 per page, last page in `last_page`. |
/pazaruvaj/v1/category3 creditsOne pazaruvaj.com category listing (e.g. 3277 = Мобилни телефони (GSM)) with the category's own product total, sort and paging, 25 per page; price in EUR as printed plus the lev figures. Category ids are the number after '-c' in a pazaruvaj.com URL.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| category | required | — | Category id (the number after '-c' in a category URL, e.g. mobiltelefon-c3277 → 3277), the slug 'mobiltelefon-c3277', or the `category_id` of a search row. |
| sort = popular | optional | popular · price_asc · price_desc · rating · name | Result order. |
| page = 1 | optional | 1–100 | Result page. Search: 20 per page, at most 100 pages (the site's own pager limit). Category: 25 per page, last page in `last_page`. |
/pazaruvaj/v1/product3 creditsOne pazaruvaj.com product page: title, brand, category path, the lowest current price in EUR (and in lev), the highest current price in lev only (`highest_price_bgn`; `highest_price` stays null because the site gives it in lev), offer counts (paid / sponsored / free listings), rating (0-5 and 0-100) with review count, the specification text, and the same product's best price on arukereso.hu and compari.ro converted to EUR by the site.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | optional | — | Pazaruvaj product id: the `product_id` of a search / category row, also the number after '-p' in a pazaruvaj.com product URL (…/iphone-15-128gb-p996936880/). 'p996936880' is accepted too. Provide product_id OR url. |
| url | optional | — | A pazaruvaj.com product URL; alternative to product_id. |
/pazaruvaj/v1/offers3 creditsEvery shop offer for one pazaruvaj.com product, in the site's own order: shop, price in EUR as printed and in lev (`price_bgn`), shipping fee and total when the fee is stated, free-shipping flag ('Безплатна доставка'), stock, delivery time, shop star rating and review count, trusted-shop badge, the shop's note, whether the row is a sponsored placement, and the click-through link. A cash-on-delivery fee ('Такса при наложен платеж') is not a shipping fee: it stays in `shipping_text` and leaves the total null.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | optional | — | Pazaruvaj product id: the `product_id` of a search / category row, also the number after '-p' in a pazaruvaj.com product URL (…/iphone-15-128gb-p996936880/). 'p996936880' is accepted too. Provide product_id OR url. |
| url | optional | — | A pazaruvaj.com product URL; alternative to product_id. |
/pazaruvaj/v1/price_history1 creditThe pazaruvaj.com price chart for one product: the lowest and the average shop price over time ('минимална цена', 'средна цена'), in EUR as the site draws it (`display_euro: true`), points roughly monthly, then denser.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| product_id | optional | — | Pazaruvaj product id: the `product_id` of a search / category row, also the number after '-p' in a pazaruvaj.com product URL (…/iphone-15-128gb-p996936880/). 'p996936880' is accepted too. Provide product_id OR url. |
| url | optional | — | A pazaruvaj.com product URL; alternative to product_id. |
curl -X POST https://api.reefapi.com/pazaruvaj/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone 15"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.