Com APIjumia.com.ng ↗
Access Jumia Nigeria product listings, flash sales, specs, pricing in NGN, ratings, and category navigation via a structured REST API.
What is the Com API?
The Jumia Nigeria API provides 5 endpoints for extracting product data from jumia.com.ng, covering keyword search, category browsing, individual product details, flash sales, and the full category navigation tree. The get_product_details endpoint returns structured specifications, current and original pricing, discount percentages, brand, and review summaries for any product URL on the platform. All pricing is denominated in NGN.
curl -X GET 'https://api.parse.bot/scraper/7d6997a8-af3e-435a-9395-25a7f80366e9/search_products?page=1&brand=hp&query=laptop&category=laptops&price_max=500000&price_min=50000' \ -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-com-ng-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.
"""
Jumia Nigeria API Client
Search and extract product data from Jumia Nigeria including electronics, gaming laptops, flash sales, and category listings.
Get your API key from: https://parse.bot/settings
"""
from parse_apis.jumia_nigeria_api import Jumia, Product, ProductDetail, Category
# Initialize the client
jumia = Jumia()
# Search for laptops
for product in jumia.products.search(query="laptop", price_max=500000):
print(product.name, product.price, product.discount)
# Browse gaming laptops
for laptop in jumia.products.gaming(brand="hp"):
print(laptop.name, laptop.price, laptop.reviews_count)
# Get detailed product information via sub-resource
for product in jumia.products.search(query="samsung phone"):
detail = product.details.get()
print(detail.title, detail.price, detail.rating)
break
# Get product details directly by URL
detail = jumia.productdetails.get(url="https://www.jumia.com.ng/hp-victus-15-gaming-401754409.html")
print(detail.title, detail.specifications)
# Check current flash sales
for item in jumia.products.flash_sales():
print(item.name, item.price, item.old_price)
# Browse all categories
for category in jumia.categories.list():
print(category.name, category.url)
for sub in category.subcategories:
print(sub.name, sub.url)
Search for products on Jumia Nigeria by keyword, category, brand, and price range. Returns paginated product listings with pricing, ratings, and availability information. At least one of query or category should be provided for meaningful results.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| brand | string | Brand name or slug to filter results (e.g. 'hp', 'samsung'). |
| query | string | Search keyword (e.g. 'laptop', 'samsung phone'). |
| category | string | Category slug used in the URL path (e.g. 'laptops', 'smartphones'). |
| price_max | integer | Maximum price filter in NGN. Must be used together with price_min. |
| price_min | integer | Minimum price filter in NGN. Must be used together with price_max. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"products": "array of product objects with keys: name, price, old_price, discount, rating, reviews_count, url, sku",
"has_next_page": "boolean, whether more results are available",
"total_results_text": "string or null, text summary of total results from the page"
},
"sample": {
"data": {
"page": 1,
"products": [
{
"sku": "DE168CL7GPWQYNAFAMZ",
"url": "https://www.jumia.com.ng/probook-x360-435-g8-touch-mpg11932178.html",
"name": "Hp EliteBook 840 G6 Intel Core I5-8GB RAM-256GB SSD",
"price": "₦ 378,300",
"rating": 4.4,
"discount": "50%",
"old_price": "₦ 750,000",
"reviews_count": 16
}
],
"has_next_page": true,
"total_results_text": null
},
"status": "success"
}
}About the Com API
Search and Browse Products
The search_products endpoint accepts a query string along with optional filters for category, brand, price_min, and price_max (both price filters must be supplied together, in NGN). It returns a paginated list of product objects, each containing name, price, old_price, discount, rating, reviews_count, url, and sku. The has_next_page boolean and total_results_text field make it straightforward to iterate through multi-page result sets. The get_gaming_laptops endpoint exposes the same response shape scoped to Jumia's laptops category, accepting the same brand and price filters.
Product Details and Specifications
get_product_details takes a full or relative Jumia product URL and returns a richer payload than the listing endpoints: a specifications object with key-value pairs (e.g. RAM, storage, display size), a product_details prose description, total_reviews text, and resolved brand alongside pricing fields. This is the endpoint to use when you need structured spec data beyond what appears in search results.
Flash Sales and Category Navigation
get_flash_sales returns all products currently featured in the flash sales section — no inputs required. Each product object includes discount and old_price, making it useful for tracking promotional pricing. get_category_list returns the full two-level navigation tree: top-level category names and URLs, each with a subcategories array of child name/URL pairs. The category slugs returned here can feed directly into the category parameter of search_products.
The Com API is a managed, monitored endpoint for jumia.com.ng — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when jumia.com.ng 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.com.ng 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?+
- Monitor NGN price changes across a product category by polling
search_productswith a fixedcategoryslug over time. - Build a flash-sale alert system using
get_flash_salesto detect new discounted products and theirdiscountandold_pricevalues. - Populate a product comparison tool with structured specs by calling
get_product_detailsfor multiple SKUs and diffing theirspecificationsobjects. - Aggregate laptop listings by brand for a price-tracking dashboard using
get_gaming_laptopswith thebrandfilter. - Generate a sitemap of Jumia Nigeria's category structure by consuming the
categoriesandsubcategoriesarrays fromget_category_list. - Enrich an affiliate feed with current pricing, ratings, and discount percentages pulled from
search_productsandget_product_details. - Filter products within a specific NGN budget range by combining
price_minandprice_maxonsearch_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 | 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 Nigeria have an official developer API?+
What does `get_product_details` return that listing endpoints do not?+
get_product_details returns a specifications object with structured key-value pairs (such as display size or battery capacity), a product_details prose description, and a total_reviews text string. Listing endpoints like search_products only return summary fields: name, price, old_price, discount, rating, reviews_count, url, and sku.Can I retrieve individual customer reviews and review text for a product?+
get_product_details returns total_reviews as a count string and rating as a score, but individual review text and reviewer metadata are not included. You can fork this API on Parse and revise it to add an endpoint that returns per-review content.Is pagination supported across all listing endpoints?+
search_products and get_gaming_laptops both accept a page integer parameter and return has_next_page to indicate whether additional pages exist. get_flash_sales returns all current flash sale products in a single response with no pagination input. get_category_list also returns a single flat response.