jumia.com.gh APIjumia.com.gh ↗
Access Jumia Ghana product listings, pricing, ratings, variants, and categories via 5 structured endpoints. Search, browse, and retrieve product details.
curl -X GET 'https://api.parse.bot/scraper/7eac180a-7816-41f6-a068-80621f5e23bd/search_products?page=2&query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Jumia Ghana by keyword. Returns paginated product listings with pricing, ratings, and category information.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| queryrequired | string | Search query (e.g., 'samsung phone', 'laptop', 'shoes') |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"query": "string, the search query used",
"products": "array of product objects with sku, name, brand, url, image, price, price_formatted, old_price, discount, rating, total_ratings, categories, is_shop_express, is_buyable, seller_id",
"total_pages": "integer, total number of pages available",
"total_products": "integer, total number of matching products",
"products_on_page": "integer, number of products on this page"
},
"sample": {
"data": {
"page": 1,
"query": "samsung phone",
"products": [
{
"sku": "SA948MP3GY5U0NAFAMZ",
"url": "https://www.jumia.com.gh/samsung-galaxy-a06-6.7-64gb-4gb-ram-50mp-rear-8mp-front-5000-mah-black-284266890.html",
"name": "Samsung Galaxy A06 - 6.7\" - 64GB + 4GB RAM - 50MP Rear / 8MP Front - 5000 mAh - Black",
"brand": "Samsung",
"image": "https://gh.jumia.is/unsafe/fit-in/300x300/filters:fill(white)/product/09/8662482/1.jpg?7253",
"price": "1098.18",
"rating": 4.1,
"discount": "86%",
"old_price": "GH₵ 8 000",
"seller_id": 67422,
"categories": [
"Phones & Tablets",
"Mobile Phones",
"Smartphones"
],
"is_buyable": true,
"total_ratings": 190,
"is_shop_express": false,
"price_formatted": "GH₵ 1 098"
}
],
"total_pages": 30,
"total_products": 1183,
"products_on_page": 40
},
"status": "success"
}
}About the jumia.com.gh API
The Jumia Ghana API provides 5 endpoints to search products, browse category listings, retrieve full product details, list all categories, and fetch search autocomplete suggestions from jumia.com.gh. The get_product_details endpoint returns variant-level data including per-SKU pricing, stock status, and buyability flags, while search_products covers pagination, discount fields, and aggregate rating counts across Jumia Ghana's catalog.
Search and Browse
The search_products endpoint accepts a query string and an optional page integer, returning a paginated list of products with fields like sku, name, brand, price, price_formatted, old_price, discount, rating, total_ratings, and url. The response also includes total_products and total_pages so you can walk through all matching results systematically. The get_category_products endpoint works the same way but takes a category_slug instead of a keyword — slugs are discovered via get_categories.
Category Navigation
get_categories requires no inputs and returns all available top-level and sub-categories as an array of objects, each containing name, slug, and url. The total_categories count is included at the top level. These slugs feed directly into get_category_products, so you can enumerate the full navigation tree and then pull products for each node programmatically.
Product Detail and Variants
get_product_details takes a product_url — either the full URL or just the path component like /product-name-and-id.html — and returns a detailed record. This includes an images array with multiple product image URLs, a variants array where each entry carries its own sku, price, price_formatted, is_buyable, and stock_info fields. This makes it possible to track availability across color, size, or storage variants without a separate call per variant.
Search Suggestions
get_search_suggestions accepts a partial query string and returns a suggestions array where each entry has a text label and a url. This mirrors the autocomplete behavior on the Jumia Ghana site and is useful for query expansion, spell-check hinting, or building search UIs that guide users toward terms likely to return results.
- Track price drops and discount percentages on specific products using
old_priceanddiscountfields fromsearch_products. - Build a product availability monitor by polling
get_product_detailsand checkingis_buyableandstock_infoacross variant SKUs. - Aggregate category-level pricing data by iterating
get_categoriesslugs and paginating throughget_category_products. - Power an autocomplete search box with real Jumia Ghana suggestions via
get_search_suggestionsfor partial query inputs. - Compare brand representation across categories by extracting the
brandfield from product listings across multiple category slugs. - Compile a product image dataset using the
imagesarray returned byget_product_detailsfor catalog or ML training purposes. - Monitor rating trends over time by recording
ratingandtotal_ratingsfromsearch_productson a recurring schedule.
| 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 Ghana have an official public developer API?+
What does `get_product_details` return that the listing endpoints don't?+
search_products, get_category_products) return summary fields like name, price, rating, and discount. get_product_details adds a full images array with multiple image URLs, a variants array with per-variant sku, price_formatted, is_buyable, and stock_info, and the product id. Stock status at the variant level is only available through this endpoint.Does the API expose seller information or seller ratings?+
Are there any pagination limitations to be aware of?+
search_products and get_category_products return total_pages and total_products so you can iterate reliably. However, very broad queries or high-traffic categories may return large total_pages values. The API reflects what Jumia Ghana surfaces for a given page number, so pages beyond what the site indexes will return empty product arrays.