jumia.com.ng APIjumia.com.ng ↗
Access Jumia Nigeria product listings, flash sales, specs, pricing in NGN, ratings, and category navigation via a structured REST API.
curl -X GET 'https://api.parse.bot/scraper/7d6997a8-af3e-435a-9395-25a7f80366e9/search_products?page=1&query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Jumia Nigeria by keyword, category, brand, and price range. Returns paginated product listings with pricing, ratings, and availability information.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| brand | string | Brand name or slug (e.g. 'hp', '246-hp'). |
| 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": "HP246CL6SL7SVNAFAMZ",
"url": "https://www.jumia.com.ng/hp-probook-11-x360-touchscreen-intel-celeron-128gb-ssd-4gb-ram-windows10-pro-free-usb-light-419161801.html",
"name": "Hp ProBook 11 X360-TOUCHSCREEN Intel Celeron 128GB SSD-4GB RAM WINDOWS10 Pro & Free USB Light",
"price": "₦ 200,000",
"rating": 5,
"discount": "50%",
"old_price": "₦ 400,000",
"reviews_count": 3
}
],
"has_next_page": true,
"total_results_text": null
},
"status": "success"
}
}About the jumia.com.ng 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.
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.
- 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 | 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 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.