jumia.ug APIjumia.ug ↗
Access Jumia Uganda product listings, prices, reviews, flash sales, and category data via 6 structured API endpoints. Covers search, details, sellers, and stock status.
curl -X GET 'https://api.parse.bot/scraper/f85d0683-7aa3-4d2d-9e7b-514db4bf538a/search_products?page=1&query=samsung' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword with optional pagination. Returns product listings matching the query.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search keyword. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"query": "string, the search query used",
"products": "array of product objects with name, price, old_price, discount, rating, reviews_count, url, image_url, sku, brand, category",
"total_results_text": "string, text describing total results found"
},
"sample": {
"data": {
"page": 1,
"query": "laptop",
"products": [
{
"sku": "",
"url": "https://www.jumia.ug/renewed-lenovo-100e-refurbished-laptop-259424460.html",
"name": "Lenovo 100e Refurbished Laptop, 4th Gen, 128GB SSD",
"brand": "",
"price": "UGX 319,900",
"rating": null,
"category": "",
"discount": "61%",
"image_url": "https://ug.jumia.is/unsafe/fit-in/300x300/filters:fill(white)/product/06/4424952/1.jpg",
"old_price": "UGX 820,000",
"reviews_count": 46
}
],
"total_results_text": ""
},
"status": "success"
}
}About the jumia.ug API
The Jumia Uganda API exposes 6 endpoints covering product search, full product details, customer reviews, category browsing, seller listings, and live flash sales from jumia.ug. The get_product_details endpoint returns 11 fields per product including price, brand, images, rating, and stock availability text. The get_flash_sales endpoint requires no inputs and returns all currently active flash sale products with discount and stock data.
Endpoints and Data Coverage
The API covers the core browse-and-discover surface of Jumia Uganda. search_products accepts a query string and optional page integer, returning an array of product objects each containing name, price, old_price, discount, rating, reviews_count, url, image_url, sku, brand, and category, plus a total_results_text field describing how many results Jumia reports. get_category_products and get_seller_products accept a category_slug or seller_slug respectively and return identically shaped product arrays with the same 11 fields, making it straightforward to switch between browse modes.
Product Details and Reviews
get_product_details takes a full product URL or slug and returns a richer record: title, sku, brand, price, currency, rating, images (with contentUrl and thumbnailUrl arrays), description, and items_left for stock availability text. The sku field from this response is the required input for get_product_reviews, which returns paginated review objects containing rating, title, body, date, user, and verified status, plus a summary.total_ratings integer.
Flash Sales
get_flash_sales takes no inputs and returns products and total_products. Each product object in the flash sales response carries the standard 11 product fields plus an additional field for flash-sale-specific stock status, making it useful for tracking deal depth and remaining inventory on time-limited offers.
- Track price changes across categories by polling
get_category_productsforpriceandold_pricefields over time. - Aggregate seller catalogs by querying
get_seller_productswith a knownseller_slugto inventory a store's full product range. - Monitor flash sale depth using
get_flash_salesto capturediscount,price, and stock status for all active deals. - Build product review feeds by combining
get_product_detailsto retrieveskuand thenget_product_reviewsfor paginatedbody,rating, andverifiedreview data. - Compare brand availability by running
search_productswith brand name queries and extracting thebrandandcategoryfields. - Surface stock alerts by checking the
items_leftfield fromget_product_detailsfor low-inventory signals on specific products.
| 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 Jumia Uganda have an official developer API?+
What does `get_product_reviews` return and how do I paginate it?+
get_product_reviews requires a sku string, which you get from the sku field returned by get_product_details. Each page returns an array of review objects with rating, title, body, date, user, and a verified boolean. The summary object contains total_ratings so you can calculate how many pages to request. Pass an integer page parameter to step through results.Does the API cover product variants (size, color, storage options) or seller ratings?+
get_product_details returns the base product record with price, images, description, and stock text, but does not expose individual variant configurations or per-seller rating breakdowns. You can fork this API on Parse and revise it to add an endpoint targeting variant or seller-rating data.Is the `items_left` stock field always populated?+
items_left field is marked as nullable (string or null) in the response schema. It reflects stock availability text when Jumia surfaces that information for a given product, but it is not guaranteed to appear on every product detail response. Plan for null values in your integration.