# Jumia Africa Catalog & Flash Deals Extractor (`nimbryxo-studio/jumia-africa-catalog-and-flash-deals-extractor`) Actor

Search, browse categories, or pull today's flash deals from Jumia across Nigeria, Kenya, Ghana, Egypt, South Africa, Morocco, Senegal, Cameroon, Tanzania, and Uganda, with price, discount, rating, and seller per product.

- **URL**: https://apify.com/nimbryxo-studio/jumia-africa-catalog-and-flash-deals-extractor.md
- **Developed by:** [Nimbryxo-studio](https://apify.com/nimbryxo-studio) (community)
- **Categories:** E-commerce, Automation, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Jumia Marketplace Catalog, Seller & Deal Extractor

Jumia is not one catalogue: each country runs its own storefront, currency, promotions and seller base. This actor collects product records from the active Jumia storefronts and gives you one clean row per product, whether you start from a keyword, a category, a flash-deal page, a product URL, a seller storefront or a brand page.

It is built for price monitoring, assortment research, seller discovery and cross-market comparison. No login, cookie or API key is needed.

### Active storefronts

The actor covers the eight Jumia retail storefronts that currently serve a catalogue:

| Storefront | Domain | Currency |
|---|---|---|
| Nigeria | jumia.com.ng | NGN |
| Kenya | jumia.co.ke | KES |
| Ghana | jumia.com.gh | GHS |
| Egypt | jumia.com.eg | EGP |
| Morocco | jumia.ma | MAD |
| Senegal | jumia.sn | XOF |
| Uganda | jumia.ug | UGX |
| Côte d'Ivoire | jumia.ci | XOF |

South Africa, Cameroon and Tanzania no longer have a Jumia retail storefront: their old domains redirect to the group site or to jumia.com. Saved tasks that still send those country names get a clear status message rather than an empty run.

### Modes

- **Search by keyword** — reads the normal Jumia search listing for the chosen market.
- **Browse a category** — accepts a friendly key such as `phones-tablets`, `electronics` or `fashion`; the actor translates it to the local path (for example `telephone-tablette` on the French-language storefronts). A full category URL also works.
- **Today's flash deals** — reads `/flash-sales/`, where Jumia publishes its current time-limited offers.
- **Specific product URLs** — opens each product page and returns the full detail record. The market is detected from the URL, so a batch can mix countries.
- **Seller storefront** — reads a seller page such as `https://www.jumia.com.ng/jckm-cod/`, adds the seller's score, follower count and performance labels to every product, and supports multiple sellers in one run.
- **Brand page** — reads `/brands/<brand>/` or a category-plus-brand page, with optional keyword narrowing.

Search, category, flash, seller and brand modes share the same listing engine, filters, sort options and pagination.

### What each record contains

Every record keeps the original output fields (`productId`, `name`, `brand`, `price`, `originalPrice`, `discountRate`, `rating`, `reviewCount`, `imageUrl`, `productUrl`, `seller`, `categories`, `description`, `country`, `currency`, `recordType`, `scrapedAt`) and adds the fields Jumia exposes on its current pages.

| Field | Meaning |
|---|---|
| `productId` | Product identifier taken from the product URL |
| `productIdNumeric` | Numeric product id at the end of the URL, when present |
| `sku` | Jumia config SKU, the stable key across markets |
| `name` | Product title |
| `brand` | Brand shown by Jumia |
| `price` | Current price in the market's local currency |
| `originalPrice` | Price before the current discount, when Jumia shows one |
| `discountRate` | Discount percentage |
| `rating` | Star rating, 0–5 |
| `reviewCount` | Number of ratings or reviews Jumia reports |
| `imageUrl` | Main product image |
| `imageUrls` | Gallery images when the product page exposes more than one |
| `productUrl` | Canonical product page URL |
| `seller` | Seller name, from the product page |
| `sellerId` | Jumia seller id, from a listing card or product page |
| `sellerUrl` | Seller storefront URL, when Jumia provides one |
| `sellerScore` | Seller score percentage |
| `sellerFollowers` | Follower count |
| `sellerPerformance` | Shipping speed, quality score, customer rating and cancellation rate labels |
| `categoryPath` | Category path shown on a listing card |
| `categories` | Category breadcrumb as a list |
| `category` | Leaf category, from the product breadcrumb |
| `breadcrumbs` | Breadcrumb names and URLs |
| `availability` | `InStock`, `OutOfStock` or `PreOrder` |
| `stockCount` | Units in stock when Jumia publishes a number |
| `condition` | `new`, `refurbished`, `used` or `packaging_damaged` |
| `isExpress` | Product is fulfilled through Jumia Express |
| `isOfficialStore` | Product is sold by an official brand store |
| `promotion` | Promotion or coupon label |
| `campaignBadge` | Campaign badge shown on the card |
| `position` | Position in the listing page |
| `inStock` | Stock signal from the listing card |
| `warranty` | Warranty text |
| `returnPolicy` | Return policy text |
| `returnDays` | Return window in days |
| `shippingFrom` | Lowest shipping price shown |
| `deliveryFees` | Delivery fee shown |
| `description` | Full description, product-detail records only |
| `specifications` | Key/value specification object, when Jumia exposes one |
| `shopType` | For example `Jumia Mall` |
| `gtin` | GTIN/barcode when present |
| `keyFeatures` | Bullet features |
| `inTheBox` | Pack contents |
| `topReviews` | Up to three recent reviews from the product page |
| `variants` | Simple variations with SKU, name, price, stock and selection state, when Jumia publishes them |
| `selectedVariantSku` | SKU of the selected simple variation |
| `isBuyable` | Jumia marks the product buyable |
| `reviews` | Full review rows when full reviews are enabled |
| `country` | Market TLD, for example `ng` |
| `countryName` | Readable market name |
| `currency` | ISO currency code |
| `recordType` | Always `product` |
| `scrapedAt` | UTC collection timestamp |
| `sourceUrl` | The listing or product page the row came from |

Empty values are omitted at every level. Numbers and booleans such as `0` and `false` are preserved when they are real values.

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | string | `search` | `search`, `categoryBrowse`, `flashSales`, `productDetails`, `sellerProducts` or `brandProducts`. |
| `country` | string | `nigeria` | Active storefront: `nigeria`, `kenya`, `ghana`, `egypt`, `morocco`, `senegal`, `uganda` or `cote_divoire`. The old `south_africa`, `cameroon` and `tanzania` values are accepted for saved tasks and return a clear "storefront closed" message. |
| `keyword` | string | – | Search words. The form is prefilled with `smartphone`; it also narrows brand searches when set. |
| `categorySlug` | string | – | Friendly key, local path or full category URL. Used by category and brand modes. |
| `productUrls` | array | `[]` | Product page URLs for `productDetails`. |
| `sellerUrls` | array | `[]` | Seller storefront URLs or slugs for `sellerProducts`. |
| `brand` | string | – | Brand name, slug or URL for `brandProducts`, or to narrow search/category results. |
| `sort` | string | `popularity` | `popularity`, `newest`, `lowest-price`, `highest-price` or `rating`. |
| `minPrice` | number | – | Lowest local price to keep. |
| `maxPrice` | number | – | Highest local price to keep. |
| `minRating` | number | – | Keep products rated at least this many stars (0–5). |
| `minDiscount` | integer | `0` | Keep products discounted by at least 0, 10, 20, 30, 40 or 50 percent. |
| `minSellerScore` | integer | `0` | Keep sellers in the 20, 40, 60 or 80 percent band and above. |
| `officialStoreOnly` | boolean | `false` | Keep official-store products only. |
| `expressOnly` | boolean | `false` | Keep Jumia Express products only. |
| `condition` | string | `any` | `any`, `new`, `refurbished` or `packaging_damaged`. |
| `enrichDetails` | boolean | `false` | Open each listing product to add description, specifications, seller score and product-page extras. |
| `partitionByPrice` | boolean | `false` | Split a large request into price bands and merge them by SKU. Runs above 1,000 items, or whose requested rows exceed `maxPages ? 40`, enable this automatically and say so in the status message. |
| `includeReviews` | boolean | `false` | Read full review pages for product-detail and enriched records. |
| `maxReviews` | integer | `20` | Reviews per product when full reviews are enabled. |
| `maxItems` | integer | `40` | Stop after this many products (up to 10,000). One listing stops at 2,000; turn on `partitionByPrice` to combine price bands. |
| `maxPages` | integer | `5` | Listing pages to read, about 40 products each. Jumia shows at most 50 pages. |

### Examples

#### Search a market

```json
{
  "mode": "search",
  "country": "kenya",
  "keyword": "laptop",
  "sort": "lowest-price",
  "minRating": 4,
  "maxItems": 80
}
```

#### Browse a category with filters

```json
{
  "mode": "categoryBrowse",
  "country": "morocco",
  "categorySlug": "phones-tablets",
  "minPrice": 1000,
  "maxPrice": 5000,
  "minDiscount": 20,
  "officialStoreOnly": true,
  "maxItems": 120
}
```

#### Read a brand page

```json
{
  "mode": "brandProducts",
  "country": "nigeria",
  "brand": "samsung",
  "categorySlug": "phones-tablets",
  "maxItems": 100
}
```

#### Read a seller storefront

```json
{
  "mode": "sellerProducts",
  "country": "ghana",
  "sellerUrls": ["https://www.jumia.com.gh/his-majesty-phones-limited-ca/"],
  "enrichDetails": true,
  "maxItems": 60
}
```

#### Full details for product URLs

```json
{
  "mode": "productDetails",
  "productUrls": [
    "https://www.jumia.com.ng/samsung-galaxy-a06-6.7-4gb-ram128gb-rom-android-14-black-401614264.html"
  ]
}
```

### How it works

Jumia serves its catalogue as server-rendered HTML. Listing cards carry product identity, price, discount, rating, review count, seller id, category path, position and badges. Product pages add a schema.org `Product` block with price, currency, availability, seller, barcode, specifications, rating count and reviews, plus the seller card, warranty and return policy.

Cloudflare challenges browser-shaped traffic. The actor identifies itself as a crawler and uses a matching TLS profile, which Jumia's own `robots.txt` permits at a low request rate. It requests pages one at a time with a delay, and only falls back to an Apify proxy if a direct request is blocked. There is no proxy field to configure.

### FAQ

**Do I need a proxy or cookies?**
No. The actor works without either. If Jumia blocks a direct request, the actor retries and then uses Apify's automatic proxy pool.

**Why only eight countries?**
Those are the storefronts that currently serve a Jumia catalogue. South Africa, Cameroon and Tanzania redirect away from retail. The actor reports that instead of returning an empty dataset.

**How many products can one listing return?**
Jumia caps a single listing at 50 pages of about 40 products, so 2,000 is the ceiling for one keyword, category, seller or brand. Some products repeat across pages; a 50-page slice returned about 1,970 unique products. Turn on `partitionByPrice` to collect adjacent price bands and merge them by SKU; a local 2,500-item run across two bands returned 2,500 unique products.

**What is the difference between `price` and `originalPrice`?**
`price` is what the buyer pays now. `originalPrice` is the struck-through price Jumia shows next to it. Both are in the market's currency; `currency` tells you which one.

**Why are some fields missing?**
Jumia does not publish every field for every product. Description, specifications and the image gallery come from product pages, so they appear in `productDetails` mode or when `enrichDetails` is on. Unrated products have no rating. Variants appear when Jumia publishes simple variations. Full reviews require `includeReviews`. A seller such as Jumia itself may have no storefront URL.

**Can I mix markets in one run?**
Yes in `productDetails` and `sellerProducts`, because the market is read from each URL. Keyword, category, flash and brand modes use the selected `country`.

**Are old saved tasks still supported?**
The original mode names and output fields remain. Legacy input keys are read in code, so a saved task keeps working even if its field is no longer shown on the form.

**How do I get more than 2,000 products?**
Requests above 1,000 items, or whose requested rows exceed `maxPages ? 40`, automatically use `partitionByPrice` so they finish under the 300-second run limit; you can also set it explicitly. The actor walks price bands, keeps one row per SKU, and stops at `maxItems` (up to 10,000). One listing still has its own 50-page cap.

**Can I get every review?**
Set `includeReviews` to true and choose `maxReviews`. Review pages are read in order; `topReviews` remains the three-review summary.

**Does the actor keep price history?**
No. Jumia publishes the current and struck-through price, not a history. Schedule reruns and compare `price` by `sku` over time.

**Is this affiliated with Jumia?**
No. This actor reads public Jumia pages and is not affiliated with, endorsed by, or connected to Jumia.

# Actor input Schema

## `mode` (type: `string`):

How to find products. Search uses a keyword, category browses a catalog section, flashSales reads today's deals, productDetails opens specific URLs, sellerProducts reads a seller storefront, and brandProducts reads a brand page.

## `country` (type: `string`):

The active Jumia country storefront to use. Prices are returned in that market's local currency.

## `keyword` (type: `string`):

Product words to search for. Also narrows brand listings when set.

## `categorySlug` (type: `string`):

A category path or a friendly key. Examples: phones-tablets, electronics, fashion, home-office. The actor translates the key to the selected market's own URL (for example telephone-tablette on jumia.ma). A full Jumia category URL also works.

## `productUrls` (type: `array`):

Jumia product page URLs for the specific product mode. The market is detected from each URL.

## `sellerUrls` (type: `array`):

Seller storefront URLs (or slugs like 'jckm-cod') for the seller mode. A full seller profile URL is accepted too.

## `brand` (type: `string`):

Brand name, slug or brand URL. Used by the brand mode and to narrow search/category results. Examples: samsung, apple, tecno, or https://www.jumia.com.ng/brands/apple/.

## `sort` (type: `string`):

Order of listing results, using the sort options Jumia itself offers.

## `minPrice` (type: `number`):

Lowest price to keep, in the selected market's local currency.

## `maxPrice` (type: `number`):

Highest price to keep, in the selected market's local currency.

## `minRating` (type: `number`):

Keep products rated at least this many stars (0-5).

## `minDiscount` (type: `string`):

Keep products discounted by at least this percentage.

## `minSellerScore` (type: `string`):

Keep products from sellers above a Jumia seller-score band.

## `officialStoreOnly` (type: `boolean`):

Keep products sold by brand-authorised official stores.

## `expressOnly` (type: `boolean`):

Keep products fulfilled through Jumia Express.

## `condition` (type: `string`):

Filter by product condition. Jumia exposes new items, refurbished items and packaging-damaged items through different filters.

## `enrichDetails` (type: `boolean`):

Open each product page found in a listing to add description, specifications, seller score, warranty, return policy and the image gallery. Slower and more request-heavy.

## `partitionByPrice` (type: `boolean`):

Split a large request into price bands and merge them by product SKU. Use this to go past one listing's 2,000-product / 50-page slice.

## `includeReviews` (type: `boolean`):

For product detail and enriched listings, read the product's review pages and add them to the record.

## `maxReviews` (type: `integer`):

How many customer reviews to include per product when full reviews are enabled.

## `maxItems` (type: `integer`):

Stop after this many product records. Jumia caps one listing at 2,000 products (50 pages); enable price partitioning to combine bands.

## `maxPages` (type: `integer`):

How many listing pages to read, about 40 products per page. Jumia shows at most 50 pages for one listing.

## Actor input object example

```json
{
  "mode": "search",
  "country": "nigeria",
  "keyword": "smartphone",
  "productUrls": [],
  "sellerUrls": [],
  "sort": "popularity",
  "minDiscount": "0",
  "minSellerScore": "0",
  "officialStoreOnly": false,
  "expressOnly": false,
  "condition": "any",
  "enrichDetails": false,
  "partitionByPrice": false,
  "includeReviews": false,
  "maxReviews": 20,
  "maxItems": 40,
  "maxPages": 5
}
```

# Actor output Schema

## `products` (type: `string`):

Dataset containing one record per Jumia product, with listing-only fields or full product-page details depending on the selected mode.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "country": "nigeria",
    "keyword": "smartphone",
    "productUrls": [],
    "sellerUrls": [],
    "sort": "popularity",
    "minDiscount": "0",
    "minSellerScore": "0",
    "officialStoreOnly": false,
    "expressOnly": false,
    "condition": "any",
    "enrichDetails": false,
    "partitionByPrice": false,
    "includeReviews": false,
    "maxReviews": 20,
    "maxItems": 40,
    "maxPages": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("nimbryxo-studio/jumia-africa-catalog-and-flash-deals-extractor").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "country": "nigeria",
    "keyword": "smartphone",
    "productUrls": [],
    "sellerUrls": [],
    "sort": "popularity",
    "minDiscount": "0",
    "minSellerScore": "0",
    "officialStoreOnly": False,
    "expressOnly": False,
    "condition": "any",
    "enrichDetails": False,
    "partitionByPrice": False,
    "includeReviews": False,
    "maxReviews": 20,
    "maxItems": 40,
    "maxPages": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("nimbryxo-studio/jumia-africa-catalog-and-flash-deals-extractor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "country": "nigeria",
  "keyword": "smartphone",
  "productUrls": [],
  "sellerUrls": [],
  "sort": "popularity",
  "minDiscount": "0",
  "minSellerScore": "0",
  "officialStoreOnly": false,
  "expressOnly": false,
  "condition": "any",
  "enrichDetails": false,
  "partitionByPrice": false,
  "includeReviews": false,
  "maxReviews": 20,
  "maxItems": 40,
  "maxPages": 5
}' |
apify call nimbryxo-studio/jumia-africa-catalog-and-flash-deals-extractor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/jumia-africa-catalog-and-flash-deals-extractor"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/bnVAdPkBepGsxqMTk/builds/Vgahsz2izw1JoWvRD/openapi.json
