prom.ua APIprom.ua ↗
Access prom.ua product listings, seller profiles, reviews, contacts, and category trees via 7 structured JSON endpoints. Built for Ukrainian marketplace data.
curl -X GET 'https://api.parse.bot/scraper/6adfcf09-7be6-4b5a-8ca2-21f98362939e/search_products?page=1&sort=rating&search_term=iphone' \ -H 'X-API-Key: $PARSE_API_KEY'
Search products by keyword on prom.ua with optional sorting and pagination. Returns a list of matching products with price, seller, and availability information.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | string | Sort order. Accepted values: 'rating', 'price', '-price'. |
| search_termrequired | string | Search query keyword (e.g. 'iphone'). |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"products": "array of product objects with id, name, price, price_numeric, url, image_url, seller_name, seller_url, availability",
"search_term": "string, the search query used",
"total_count": "integer or null, total number of matching products"
},
"sample": {
"data": {
"page": 1,
"products": [
{
"id": null,
"url": "https://prom.ua/ua/m-1830186130835876250-smartfon-apple-iphone.html?p=2974834639",
"name": "Смартфон Apple iPhone 16 128GB Black",
"price": "40 056₴",
"image_url": "https://images.prom.ua/6642547047_w200_h200_smartfon-apple-iphone.jpg",
"seller_url": "https://prom.ua/ua/c4006156-more.html",
"seller_name": "Море",
"availability": "В наявності",
"price_numeric": "40056"
}
],
"search_term": "iphone",
"total_count": null
},
"status": "success"
}
}About the prom.ua API
The prom.ua API exposes 7 endpoints covering product search, category browsing, product details, and seller intelligence from Ukraine's largest B2C marketplace. Using search_products you can query by keyword with sorting by rating or price and get back structured results including numeric price, availability, and seller URL. Separate endpoints cover the full category tree, seller contact details, and paginated seller reviews.
Product Search and Category Browsing
search_products accepts a required search_term and optional sort (rating, price, -price) and page parameters. Each result in the products array includes id, name, price, price_numeric, url, image_url, seller_name, seller_url, and availability. The total_count field gives the full result count when available. get_category_products works similarly but takes a category_url — either a full URL or path slug — and returns the same product shape. Invalid category slugs silently redirect and return empty results, so use get_category_tree first to retrieve confirmed valid category URLs and their nested subcategories.
Product Details
get_product_details takes a single product_url and returns a richer payload: characteristics (an array of name/value pairs), images (all product images), description, currency, is_available, and a seller object containing id, name, and slug. This is the only endpoint that exposes product characteristics and the full image set.
Seller Profiles, Reviews, and Contacts
get_seller_profile returns top-level seller reputation data — total_reviews and positive_reviews_percent — given a seller URL. For structured contact data, get_seller_contacts accepts a company_id and returns phones (array with number and description), contactEmail, addressText, webSiteUrl, contactPerson, and opinionStats. get_seller_reviews paginates 10 reviews per page using the same company_id; each review object includes rating, commentWork, dateCreated, authorName, and orderedProducts. The has_next_page boolean simplifies loop termination when crawling all reviews.
- Build a price comparison tool across prom.ua categories using
get_category_productswith paginated results andprice_numericfor sorting. - Monitor competitor seller reputations by polling
get_seller_profileandget_seller_reviewsfor changes inpositive_reviews_percent. - Aggregate structured product characteristics from
get_product_detailsto populate a product database with specs and images. - Discover the full prom.ua taxonomy via
get_category_treeto map Ukrainian consumer goods categories for localization projects. - Extract seller contact information — phones, email, address — via
get_seller_contactsfor B2B lead generation within a vertical. - Track keyword-based product availability using
search_productswithavailabilityfield to detect out-of-stock trends.
| 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 prom.ua offer an official developer API?+
What does `get_seller_reviews` return and how do I paginate through all reviews?+
get_seller_reviews requires a company_id (available from get_seller_profile or get_seller_contacts) and returns 10 reviews per page. Each review object includes id, authorName, rating, commentWork, dateCreated, and orderedProducts. Check the has_next_page boolean to determine whether to increment the page parameter and fetch the next batch.Are product prices always returned in Ukrainian hryvnia?+
currency field in get_product_details reflects whatever currency symbol the listing uses, but the majority of prom.ua listings are priced in UAH. The price field is a formatted string; use price_numeric from search and category endpoints when you need a number for arithmetic or sorting.Does the API cover seller product catalogs or inventory counts?+
is_available (boolean) and listing-level availability text, but does not expose full seller catalog listings or stock quantities. You can fork this API on Parse and revise it to add an endpoint that traverses a seller's storefront pages and returns their listed products.What happens if I pass an invalid category URL to `get_category_products`?+
products array. Use get_category_tree to retrieve the verified list of category url values before calling get_category_products.