Jumia APIjumia.ug ↗
Access Jumia Uganda product listings, prices, reviews, seller catalogs, and live flash sales via 6 structured API endpoints. No scraping needed.
What is the Jumia API?
The Jumia Uganda API provides 6 endpoints covering product search, category browsing, seller catalogs, individual product details, customer reviews, and live flash sales from jumia.ug. The search_products endpoint returns up to 12 fields per listing — including price, discount, brand, rating, and SKU — and the SKU ties directly into get_product_reviews for paginated customer feedback. All responses return structured JSON.
curl -X GET 'https://api.parse.bot/scraper/f85d0683-7aa3-4d2d-9e7b-514db4bf538a/search_products?page=1&query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace jumia-ug-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Jumia Uganda SDK — search products, get details, browse reviews."""
from parse_apis.jumia_uganda_api import Jumia, ProductNotFound
client = Jumia()
# Search for phones — limit caps total items fetched across all pages.
for product in client.products.search(query="samsung phone", limit=5):
print(product.name, product.price, product.discount)
# Drill into the first search result for full details.
hit = client.products.search(query="laptop", limit=1).first()
if hit:
detail = client.productdetails.get(url=hit.url)
print(detail.title, detail.price, detail.currency, detail.sku)
# Walk reviews for that product (sub-resource of ProductDetail).
for review in detail.reviews.list(limit=3):
print(review.user, review.rating, review.body[:60])
# Browse a category via constructible resource.
for product in client.category("phones-tablets").products(limit=4):
print(product.name, product.price)
# Flash sales — single-page listing of current deals.
for deal in client.products.flash_sales(limit=5):
print(deal.name, deal.price, deal.discount)
# Typed error handling when a product URL is invalid.
try:
client.productdetails.get(url="https://www.jumia.ug/nonexistent-product-000000000.html")
except ProductNotFound as exc:
print(f"Product not found: {exc.url}")
print("exercised: products.search / productdetails.get / reviews.list / category.products / flash_sales")
Full-text search over Jumia Uganda product listings. Returns paginated results matching the query keyword. Each result includes price, discount, rating, and a product URL suitable for get_product_details.
| 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-hp-refurbished-probook-230557654.html",
"name": "HP Refurbished Probook",
"brand": "",
"price": "UGX 449,000",
"rating": null,
"category": "",
"discount": "44%",
"image_url": "https://ug.jumia.is/product/45/6755032/1.jpg",
"old_price": "UGX 800,000",
"reviews_count": 505
}
],
"total_results_text": ""
},
"status": "success"
}
}About the Jumia API
Product Search and Browsing
search_products accepts a required query string and an optional page integer, returning an array of product objects with name, price, old_price, discount, rating, reviews_count, url, image_url, sku, brand, and category, plus a total_results_text string indicating the result count Jumia reports. get_category_products works similarly but scoped to a category_slug such as phones-tablets or computing, making it straightforward to iterate through a category's full catalog page by page.
Product Details and Reviews
get_product_details takes a full product URL or slug and returns structured fields from the product page: title, price, currency, brand, rating, description, images (with contentUrl and thumbnailUrl arrays), items_left for stock availability, and a sku string. That SKU is the required input for get_product_reviews, which returns paginated review objects containing rating, title, body, date, user, and a verified flag, alongside a summary object with total_ratings.
Seller Catalogs and Flash Sales
get_seller_products accepts a seller_slug (e.g., samsung-official-store) and returns the same paginated product array format used by search and category endpoints. get_flash_sales requires no inputs and returns the full set of active flash sale products along with a total_products count — each item includes the same core product fields plus stock-status data so you can monitor availability changes over time.
The Jumia API is a managed, monitored endpoint for jumia.ug — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when jumia.ug changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official jumia.ug API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track price and discount changes across Jumia Uganda categories for a price-monitoring dashboard.
- Aggregate customer reviews by SKU to build a sentiment analysis dataset for Ugandan e-commerce.
- Monitor flash sale inventory using
get_flash_salesto alert users when specific items go on promotion. - Compare seller catalogs side by side by querying multiple seller slugs via
get_seller_products. - Build a product feed for a comparison site using
search_productsfiltered by brand and category. - Extract product specifications and images via
get_product_detailsto populate a localized product database. - Analyze rating distributions across categories by combining
get_category_productswithget_product_reviews.
| 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 | 100 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?+
How do I get reviews for a product I found in search results?+
search_products, get_category_products, or get_seller_products includes a sku field. Pass that SKU to get_product_reviews as the required sku parameter. If the SKU is null in a listing, you can first call get_product_details with the product's url to retrieve the SKU, then call get_product_reviews.Does the API return seller ratings or seller-level metrics?+
rating and reviews_count fields, and get_seller_products lists a seller's products, but it does not expose seller reputation scores, fulfillment metrics, or response rates. You can fork this API on Parse and revise it to add a seller-profile endpoint covering those fields.What stock information does the API expose?+
get_product_details returns an items_left field containing Jumia's stock availability text for a single product. get_flash_sales also includes stock-status data per flash sale item. Category and search listing endpoints do not include per-item stock counts — only price, discount, and rating fields.