# Jumia Marketplace Scraper - Products, Prices, Reviews & Sellers (`abotapi/jumia-marketplace-scraper`) Actor

Scrape Jumia, Africa's largest marketplace: products with local prices, discounts, ratings, official-store badges and customer reviews across the Nigeria, Egypt, Kenya and Morocco storefronts. Search keywords or paste links, and monitor price changes with recurring updates.

- **URL**: https://apify.com/abotapi/jumia-marketplace-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 product results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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 Scraper

Scrape products, prices, sellers and customer reviews from Jumia, Africa's largest marketplace. One actor covers four country storefronts: Nigeria (jumia.com.ng), Egypt (jumia.com.eg), Kenya (jumia.co.ke) and Morocco (jumia.ma). Each market is its own catalogue with its own currency, and the actor pins the connection exit to the market you select.

### What you get

Every product record carries:

- Title, display name, brand and category path
- Price in the market's local currency, the was-price and the discount percentage
- Rating average and rating count
- Official-store badge (official store vs marketplace seller), campaign badges
- Seller id, express and sponsored flags, buyable flag
- The product link and image link, and the market it came from

With the detail reader on, each record also carries the description, the specification table, the barcode, the stock state and the seller's name, shop link, seller score and follower count.

With the reviews reader on, each record also carries its customer reviews (star rating, title, text, date, author, verified-purchase flag), the total review count and the star histogram. The reviews reader walks every page of a product's reviews, not just the first one.

Vendor shop links yield one vendor row (name, shop link, seller score, follower count) followed by that shop's products.

### How to use it

1. Pick a mode. **Keyword search** walks one market's catalogue for your search terms. **My own links** reads exactly the product pages, vendor shops or catalogue links you paste.
2. In keyword search, pick the market and enter your search terms. Optional filters: ordering, brand names, official stores only, minimum discount.
3. Set **Max records** to bound the run. 0 means no limit: the walk then ends when the catalogue runs out.
4. Turn on **Read product detail pages** and **Read customer reviews** when you need depth. Both cost a small per-product surcharge, and reviews add one more surcharge event for every full 5 reviews collected; a listing-only run is the cheapest.
5. For daily or weekly monitoring, turn on **Recurring updates**: the first run returns everything, later runs return only what changed, each row labelled NEW, UPDATED, REAPPEARED or EXPIRED in a changeType column.

#### Example input (illustrative values, not from a live listing)

```json
{
  "mode": "search",
  "country": "ng",
  "queries": ["wireless earbuds"],
  "sort": "lowest-price",
  "brands": ["Sample Brand"],
  "officialStoreOnly": true,
  "minDiscount": 15,
  "maxItems": 100,
  "fetchDetails": true,
  "fetchReviews": true,
  "maxReviewsPerProduct": 10
}
```

#### Example output (illustrative values, not from a live listing)

```json
{
  "recordType": "product",
  "id": "XX000AA0ABC0DEFAF",
  "sku": "XX000AA0ABC0DEFAF",
  "name": "Sample Product Pro Wireless Earbuds - Black",
  "brand": "SAMPLEBRAND",
  "categories": ["Electronics", "Audio", "Earbuds"],
  "url": "https://www.jumia.com.ng/sample-sound-pro-earbuds-black-000000000.html",
  "currency": "XXX",
  "price": 19999.0,
  "priceDisplay": "X 19,999",
  "oldPrice": 29999.0,
  "discountPercent": 33,
  "ratingAverage": 4.3,
  "ratingCount": 214,
  "officialStore": true,
  "market": "NG",
  "sellerName": "Sample Official Store",
  "availability": "in_stock",
  "reviewsTotal": 214,
  "reviewsFetched": 10,
  "reviews": [
    {
      "rating": 5,
      "title": "Sample headline",
      "text": "Sample review text.",
      "date": "01-01-2026",
      "author": "by Jane Doe",
      "verified": true
    }
  ],
  "changeType": "NEW"
}
```

### Notes and limits

- The marketplace refuses ordinary datacenter connections, so the input defaults to the premium consumer connection tier pinned to the selected market. Running it needs a paid plan that includes that tier; you can also paste your own connection links in the Connection section.
- Reviews are collected per product up to **Max reviews per product** (0 = every review). A record whose reviews change counts as UPDATED under recurring updates.
- **Continue a previous run** finishes one interrupted run without re-collecting rows the earlier run already returned. Recurring updates and continue-a-previous-run are mutually exclusive: use one or the other.
- Filters resolve against the filters the marketplace itself offers for your search. A brand name the catalogue does not offer stops the run with the list of available brands, so a typo can never silently return everything.
- A run that reads nothing because the site refused every page fails loudly with a connection-problem verdict; a genuine empty search succeeds with zero rows and the verdict on the run page.

### Send results into your apps (MCP connectors)

Optionally pipe results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector under Apify, Settings, API & Integrations, then fill in:

| Input field | What it does |
|---|---|
| `mcpConnectors` | The connectors to export into. Notion gets a rich page-per-item export; other connectors get a best-effort write or a digest. |
| `notionParentPageUrl` | URL or id of the Notion page under which item pages are created. Required for the Notion connector, ignored by others. |
| `maxNotifyListings` | Cap on items written to each connector per run. Does not affect the dataset. |

The export is a delivery step after the scrape. It never changes the dataset.

### Compute and billing

- Pay per event: a start event, a small per-record event for each product or vendor row, and a detail-enrichment surcharge for each product whose detail page or reviews were read. Reviews add more: every full 5 reviews collected on a product bills one more detail-enrichment event (1-4 extra reviews cost nothing).
- Default memory is 512 MB; a listing-only run stays well inside that.

### Support

Open an issue in the actor's support tab; include the run id and the input used.

# Actor input Schema

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

Where to collect from: a keyword search on one marketplace, or your own product, vendor and catalogue links.

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

Which country storefront to search. Each market is its own catalogue with its own currency.

## `queries` (type: `array`):

Only read when mode = keyword search. One entry per search; each search is walked forward, and all searches share the record cap.

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

Order in which products are returned for each search.

## `brands` (type: `array`):

Only read when mode = keyword search. Product brand names, e.g. Samsung or Xiaomi. Names are matched against the filters the marketplace itself offers for your search; a name it does not offer stops the run with the list of available brands, so a typo can never silently return everything.

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

Only read when mode = keyword search. Return only products sold by the marketplace's official stores.

## `minDiscount` (type: `integer`):

Only read when mode = keyword search. Return only products discounted at least this much (0 to 100). Leave 0 for no discount filter.

## `urls` (type: `array`):

Only read when mode = my own links. Paste product page links, a vendor shop link, or catalogue links (search results, categories). Each link is read on its own market; product links yield one enriched product each, catalogue links are walked forward.

## `fetchDetails` (type: `boolean`):

Open each product's own page and add the description, specifications, seller score, stock state and barcode to the record. Off by default: a run without it is much cheaper and still carries prices, discounts, ratings and badges.

## `fetchReviews` (type: `boolean`):

Collect each product's customer reviews (rating, title, text, date, author, verified-purchase flag), the rating total and the star histogram, into a reviews column on the product record. Needs the reviews toggle only; works with or without detail pages. Billed on top of the base detail-enrichment event: every full 5 reviews collected on a product adds one more detail-enrichment event (1-4 extra reviews cost nothing).

## `maxReviewsPerProduct` (type: `integer`):

Cap on customer reviews collected per product (0 = every review the product has). Every full 5 reviews collected bills one extra detail-enrichment event, so this cap is also a cost cap: 10 reviews bills 2 extra events, 500 bills 100 extra events.

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

Stop after this many records across the whole run (0 = no limit; the walk then ends when the catalogue runs out). Products and vendor header rows both count.

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

Runaway guard: an upper bound on how much is read for any single search or catalogue walk. Leave 0 to go as deep as the source serves, with the record cap above as the only real limit.

## `resumeFromRunId` (type: `string`):

Paste the run id (or dataset id) of an earlier run of this Actor to continue it. Records that run already returned are skipped, so an interrupted large collection can finish without paying for the same rows twice. Leave empty for a normal run.

## `incrementalMode` (type: `boolean`):

Turn this on for daily or weekly monitoring. The first run returns everything as NEW. Later runs return only NEW, UPDATED and REAPPEARED records, each labelled in a changeType column. Prices and rating counts move constantly on a marketplace, so a record whose only difference is a price still counts as UPDATED. Leave off for a normal one-off run.

## `stateKey` (type: `string`):

Optional. Name this monitoring campaign to keep its memory stable, or to deliberately share one memory across differently configured runs. Leave empty and the memory is keyed on the run setup automatically.

## `emitUnchanged` (type: `boolean`):

Off by default. Turn on to also return records that have not changed since the last run, labelled UNCHANGED. This returns, and bills, rows you already have.

## `emitExpired` (type: `boolean`):

Off by default. Turn on to also return records that were present before and are no longer found, labelled EXPIRED. Only produced when a run covered its whole setup, so a capped or continued run never reports records as gone. This returns, and bills, extra rows.

## `mcpConnectors` (type: `array`):

Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify, Settings, API & Integrations, then select it here. Notion gets a rich page-per-item export; other connectors get a best-effort write or digest. Leave empty to skip; never changes the dataset output.

## `notionParentPageUrl` (type: `string`):

URL or id of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors.

## `maxNotifyListings` (type: `integer`):

Cap on items written to each connector per run. Does not affect the dataset.

## `proxyConfiguration` (type: `object`):

Connection used for every request. This marketplace refuses ordinary datacenter connections, so the default requests the premium consumer connection tier pinned to the selected market; it needs a paid plan that includes that tier. You can also paste your own connection links.

## Actor input object example

```json
{
  "mode": "search",
  "country": "ng",
  "queries": [
    "phone"
  ],
  "sort": "relevance",
  "officialStoreOnly": false,
  "minDiscount": 0,
  "urls": [
    "https://www.jumia.com.ng/catalog/?q=phone"
  ],
  "fetchDetails": false,
  "fetchReviews": false,
  "maxReviewsPerProduct": 10,
  "maxItems": 20,
  "maxPages": 0,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "maxNotifyListings": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# 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": "ng",
    "queries": [
        "phone"
    ],
    "sort": "relevance",
    "officialStoreOnly": false,
    "minDiscount": 0,
    "urls": [
        "https://www.jumia.com.ng/catalog/?q=phone"
    ],
    "fetchDetails": false,
    "fetchReviews": false,
    "maxReviewsPerProduct": 10,
    "maxItems": 20,
    "maxPages": 0,
    "incrementalMode": false,
    "emitUnchanged": false,
    "emitExpired": false,
    "maxNotifyListings": 50,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/jumia-marketplace-scraper").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": "ng",
    "queries": ["phone"],
    "sort": "relevance",
    "officialStoreOnly": False,
    "minDiscount": 0,
    "urls": ["https://www.jumia.com.ng/catalog/?q=phone"],
    "fetchDetails": False,
    "fetchReviews": False,
    "maxReviewsPerProduct": 10,
    "maxItems": 20,
    "maxPages": 0,
    "incrementalMode": False,
    "emitUnchanged": False,
    "emitExpired": False,
    "maxNotifyListings": 50,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/jumia-marketplace-scraper").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": "ng",
  "queries": [
    "phone"
  ],
  "sort": "relevance",
  "officialStoreOnly": false,
  "minDiscount": 0,
  "urls": [
    "https://www.jumia.com.ng/catalog/?q=phone"
  ],
  "fetchDetails": false,
  "fetchReviews": false,
  "maxReviewsPerProduct": 10,
  "maxItems": 20,
  "maxPages": 0,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "maxNotifyListings": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call abotapi/jumia-marketplace-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,abotapi/jumia-marketplace-scraper"
        }
    }
}
```

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/OYdbxn275tAUKU7ZG/builds/EsuLmf6MAzlB7WMtj/openapi.json