Search prom.ua, compare every seller's price for the same item, and read full products, shops and reviews
Prom.ua is Ukraine's large multi-seller marketplace: thousands of shops list their own offers, so the same item often appears from many sellers at different prices.
6 active endpoints, on 1 and 2 credit tiers.
- POST/prom-ua/v1/search
- POST/prom-ua/v1/product
- POST/prom-ua/v1/reviews
- POST/prom-ua/v1/seller
- POST/prom-ua/v1/seller_reviews
- POST/prom-ua/v1/categories
What Prom.ua endpoints does ReefAPI ship?
6 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Prom.ua API
5 of 6 endpoints, ready to run
Espresso machines in stock between 2,000 and 5,000 UAH
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
How the Prom.ua API works
Prom.ua is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 491 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a product word to the cheapest trustworthy seller on prom.ua
Search with prom.ua's filters, open the item's other offers, and check the shop behind the price you want.
рожкова&in_stock=true&sort=price_asc
Offers with price, old price, wholesale tiers, availability, rating and the seller. model lists how many sellers offer the same item and at what lowest and highest price.
The full offer: description, attributes, the seller's phone, website and return days, delivery options with prices and payment options.
What unhappy buyers said about that shop, with the tags they ticked and the shop's replies.
A price comparison across Ukrainian sellers for one item, with the delivery, payment and reputation behind each price.
curl -X POST https://api.reefapi.com/prom-ua/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"кавоварка рожкова","in_stock":true}'{
"ok": true,
"data": { … },
"meta": {
"api": "prom-ua",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a Prom.ua field actually contains
Fields that read differently from how they look. Every row was measured against live prom.ua pages on 2026-10-14.
| Field | What it holds |
|---|---|
| product_id | Prom.ua's id of one seller's offer, the number after /p in a product address (prom.ua/ua/p3026527730-...). Pass it unchanged to product and reviews; a product URL works too. Search to product returned the same id, price and seller on 16 of 16 rows. |
| price, price_old | price is the price prom.ua prints in bold; price_old is the struck price, present only when the seller runs a discount. price matched the product page on 19 of 20 audited products and the search row on 20 of 20; on the 20th the page did not load in that minute. |
| wholesale_prices | The seller's wholesale (опт) tiers: a price and the minimum quantity for it, for example 47,503 UAH from 3 pieces on a phone whose retail price is 48,559. The page's structured data lists this wholesale tier as its first offer, so it disagreed with the printed price on 12 of 20 products; this API keeps the two apart. |
| price_is_from, price_on_request | price_is_from is true when prom.ua prints "від" (from) before the price. price_on_request is true when the seller shows "Ціну уточнюйте" (ask for the price); price is then null, never 0. |
| availability, availability_text, available_from | availability is prom.ua's code (avail, order = made to order, not_avail, waiting); availability_text is what the page prints ("Готово до відправки", "В наявності", "Під замовлення"). For made-to-order items available_from is the ship date the page shows (2026-10-31 on one T-shirt). Prom.ua publishes availability, not stock quantities. |
| model | The same item offered by other sellers: offers_count, sellers_count, the lowest and highest price among them and their product ids, plus the reviews of the item across all sellers. One iPhone 17 256GB had 21 offers from 21 sellers between 44,239 and 63,240 UAH. |
| seller | The shop selling this offer: id, name, city, positive-review percent and review count; product adds the phone, website, years on prom.ua, last activity, orders delivered and return days, as printed on the public product page. |
| region (filter) | Where the item ships from, which can differ from the seller's own city: for region=lviv the seller was based in Lviv on 4 of 48 rows, but all 6 checked products shipped from Lviv. |
| rating_4_plus (filter) | Prom.ua applies it to the item's rating across all sellers (model.rating), so an offer with no reviews of its own can match when other sellers' reviews of the same item average 4 or more. |
| total | Prom.ua's count is approximate: the same search returned 8,945 to 8,985 on consecutive calls, and it widens some searches with translations and synonyms (3,300 vs about 4,550 for "кавоварка рожкова"); query_expansion says when that happened. |
All prices are Ukrainian hryvnia (UAH) as the seller set them. Prices, availability and delivery options were identical read from inside and outside Ukraine (6 of 6 products). Ukrainian is the default language; lang=ru returns names and labels in Russian.
Prom.ua coverage, measured
Every number below was read from live prom.ua responses on 2026-10-14; the final run answered 89 of 89 calls as expected, including 12 of 12 invalid requests rejected with the right error.
Ukraine, prices in UAH, Ukrainian or Russian labels. "iphone" matched about 8,100 offers, "кавоварка рожкова" 3,300; prom.ua serves up to about 9,000 results per search.
"кавоварка рожкова" 3,300 → 2,000-5,000 UAH 1,662, in stock 1,391, discounted 1,264, wholesale 530, pay in parts 1,202, ships from Kyiv 1,555, from Lviv 299, Nova Poshta 3,289, pickup 998, Rozetka shops 718, used 27, with review photos 28.
Price matched the product page on 19 of 20 products from 8 searches and the search row on 20 of 20; old price 19 of 20, wholesale tiers 18 of 20 (the other 2 pages print no wholesale block but carry the same tier in their structured data).
Search to product returned the same product id, price and seller on 16 of 16 rows in two runs.
Prices, availability and delivery options were identical read from inside and outside Ukraine on 6 of 6 products.
Totals are approximate and some searches are widened with translations; about 9,000 results per search; at most 60 rows per call; availability flags, not stock counts; no delivery dates per city; no questions and answers.
What people build with Prom.ua
The jobs this data is most often used for.
endpoints
credits per call
Track prices and discounts of Ukrainian sellers on prom.ua for a list of products.
Compare every seller offering the same item, from the lowest to the highest price.
Find wholesale suppliers on prom.ua with their price tiers and minimum quantities.
Score Ukrainian shops by positive reviews, orders delivered and review tags before working with them.
What Prom.ua data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
Full pricing →- 1,000 free credits on signup, no card
- One key, all 491 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/prom-ua/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"кавоварка рожкова","in_stock":true}'import requests
r = requests.post(
"https://api.reefapi.com/prom-ua/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "кавоварка рожкова",
"in_stock": true
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Prom.ua.
Get a free key →Do I need a prom.ua account?▾
No. Everything is read logged out, and you call reefapi.com from anywhere.
Is a row a product or an offer?▾
An offer: one seller's listing with its own price and availability. The same item from other sellers is grouped under model, with the number of offers, the lowest and highest price and the other offers' ids.
Which price should I use?▾
price is what prom.ua shows as the price. price_old is the price before the seller's discount. wholesale_prices lists cheaper prices for larger quantities with the minimum quantity for each.
Which search filters are there?▾
Price range, in stock, discounted, wholesale, pay in parts, Prom-payment, free Smart delivery, delivery method, ship-from city, 4+ stars, reviews with photos, condition, brand, category and one seller. Each was checked against the unfiltered count in the same run: "кавоварка рожкова" 3,300 → 2,000-5,000 UAH 1,662, in stock 1,391, discounted 1,264, wholesale 530, ships from Kyiv 1,555, from Lviv 299, used 27, Nova Poshta 3,289, Ukrposhta 1,620, pickup 998.
How many results can I page through?▾
Up to 60 rows per call and about 9,000 results per search, which is where prom.ua itself stops serving results. Pass next_offset as offset to continue.
Do you return the seller's phone?▾
Yes, product and seller return the shop's phone, website and city exactly as prom.ua prints them on the public page, along with the shop's rating and review counts.
Why do price sorts return weak_match rows?▾
When sorted by price, prom.ua lists the close matches first and then looser ones; the API returns both and marks the second group with weak_match: true.
What is not returned?▾
Stock quantities (prom.ua shows availability, not counts), delivery dates for a city, questions and answers, and prom.ua's paid ad block.
What is the Prom.ua API?▾
Prom.ua API is a ReefAPI endpoint group for ukraine's multi-seller marketplace: price, old price, wholesale tiers, availability, seller with rating, city and phone, delivery and payment options, product and seller reviews. It returns live JSON through POST requests under /prom-ua/v1.
Is the Prom.ua API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Prom.ua calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Prom.ua login or account?▾
No login to Prom.ua is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Prom.ua data?▾
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Prom.ua API use?▾
Prom.ua actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Prom.ua from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call prom-ua actions with the same key, credit pool and JSON envelope used by normal REST requests.
231 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Prom.ua, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 490 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-14.