Com APIjumia.com.gh ↗
Access Jumia Ghana product listings, pricing, ratings, variants, and categories via 5 structured endpoints. Search, browse, and retrieve product details.
What is the Com 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.
curl -X GET 'https://api.parse.bot/scraper/7eac180a-7816-41f6-a068-80621f5e23bd/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-com-gh-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 Ghana: search products, browse categories, get details."""
from parse_apis.jumia_ghana_api import JumiaGhana, ProductNotFound
client = JumiaGhana()
# Search for products by keyword, capped at 5 results
for product in client.products.search(query="laptop", limit=5):
print(product.name, product.price_formatted, product.discount)
# Get autocomplete suggestions
suggestion = client.suggestions.search(query="samsung", limit=1).first()
if suggestion:
print(suggestion.text, suggestion.url)
# Browse a category by constructing it from its slug
phones = client.category(slug="phones-tablets")
for phone in phones.products(limit=3):
print(phone.name, phone.price, phone.brand)
# Drill into product details from a search result
product = client.products.search(query="shoes", limit=1).first()
if product:
try:
detail = product.details()
print(detail.name, detail.price_formatted, detail.seller_name)
for variant in detail.variants:
print(variant.sku, variant.price_formatted, variant.stock_info)
except ProductNotFound as exc:
print(f"Product gone: {exc.product_url}")
# List all categories
for cat in client.categories.list(limit=5):
print(cat.name, cat.slug)
print("exercised: products.search / suggestions.search / category.products / product.details / categories.list")
Search for products on Jumia Ghana by keyword. Returns paginated product listings with pricing, ratings, and category information. Each page returns up to 40 products. Use the total_pages field to know how many pages are available.
| 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": "laptop",
"products": [
{
"sku": "WS788CL3Y3ML1NAFAMZ",
"url": "https://www.jumia.com.gh/wsd-brand-new-e142n-14laptop-290747683.html",
"name": "WSD Brand new E142N- 14\"Laptop Intel N3450 6GB+256 GB SSD",
"brand": "WSD",
"image": "https://gh.jumia.is/unsafe/fit-in/300x300/filters:fill(white)/product/38/6747092/1.jpg",
"price": "3201.00",
"rating": 4,
"discount": "12%",
"old_price": "GH₵ 3 625",
"seller_id": 74925,
"categories": [
"Computing",
"Computers & Accessories"
],
"is_buyable": true,
"total_ratings": 1,
"is_shop_express": true,
"price_formatted": "GH₵ 3 201"
}
],
"total_pages": 42,
"total_products": 1672,
"products_on_page": 40
},
"status": "success"
}
}About the Com API
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.
The Com API is a managed, monitored endpoint for jumia.com.gh — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when jumia.com.gh 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.gh 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 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 | 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 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.