{
  "data": {
    "id": "Vgahsz2izw1JoWvRD",
    "actId": "bnVAdPkBepGsxqMTk",
    "userId": "IYgBDiXtHOijAaUel",
    "startedAt": "2026-11-21T19:06:36.621Z",
    "finishedAt": "2026-11-21T19:06:58.655Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 21945,
      "runTimeSecs": 21.945,
      "computeUnits": 0.024383333333333333,
      "imageSizeBytes": 359718400
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "QYo53EZkJk0prePWY",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Jumia marketplace input\",\n  \"description\": \"Choose a Jumia storefront and a way to collect products: keyword search, category, flash deals, product URLs, seller storefronts, or brand pages.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Collection mode\",\n      \"type\": \"string\",\n      \"description\": \"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.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"search\",\n        \"categoryBrowse\",\n        \"flashSales\",\n        \"productDetails\",\n        \"sellerProducts\",\n        \"brandProducts\"\n      ],\n      \"enumTitles\": [\n        \"Search by keyword\",\n        \"Browse a category\",\n        \"Today's flash deals\",\n        \"Specific product URLs\",\n        \"Seller storefront\",\n        \"Brand page\"\n      ],\n      \"default\": \"search\",\n      \"prefill\": \"search\"\n    },\n    \"country\": {\n      \"title\": \"Jumia storefront\",\n      \"type\": \"string\",\n      \"description\": \"The active Jumia country storefront to use. Prices are returned in that market's local currency.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"nigeria\",\n        \"kenya\",\n        \"ghana\",\n        \"egypt\",\n        \"morocco\",\n        \"senegal\",\n        \"uganda\",\n        \"cote_divoire\",\n        \"south_africa\",\n        \"cameroon\",\n        \"tanzania\"\n      ],\n      \"enumTitles\": [\n        \"Nigeria - jumia.com.ng (NGN)\",\n        \"Kenya - jumia.co.ke (KES)\",\n        \"Ghana - jumia.com.gh (GHS)\",\n        \"Egypt - jumia.com.eg (EGP)\",\n        \"Morocco - jumia.ma (MAD)\",\n        \"Senegal - jumia.sn (XOF)\",\n        \"Uganda - jumia.ug (UGX)\",\n        \"Cote d'Ivoire - jumia.ci (XOF)\",\n        \"South Africa - closed, no retail storefront\",\n        \"Cameroon - closed, no retail storefront\",\n        \"Tanzania - closed, no retail storefront\"\n      ],\n      \"default\": \"nigeria\",\n      \"prefill\": \"nigeria\"\n    },\n    \"keyword\": {\n      \"title\": \"Keyword\",\n      \"type\": \"string\",\n      \"description\": \"Product words to search for. Also narrows brand listings when set.\",\n      \"editor\": \"textfield\",\n      \"default\": \"\",\n      \"prefill\": \"smartphone\"\n    },\n    \"categorySlug\": {\n      \"title\": \"Category\",\n      \"type\": \"string\",\n      \"description\": \"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.\",\n      \"editor\": \"textfield\"\n    },\n    \"productUrls\": {\n      \"title\": \"Product URLs\",\n      \"type\": \"array\",\n      \"description\": \"Jumia product page URLs for the specific product mode. The market is detected from each URL.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"sellerUrls\": {\n      \"title\": \"Seller URLs or slugs\",\n      \"type\": \"array\",\n      \"description\": \"Seller storefront URLs (or slugs like 'jckm-cod') for the seller mode. A full seller profile URL is accepted too.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"brand\": {\n      \"title\": \"Brand\",\n      \"type\": \"string\",\n      \"description\": \"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/.\",\n      \"editor\": \"textfield\"\n    },\n    \"sort\": {\n      \"title\": \"Sort order\",\n      \"type\": \"string\",\n      \"description\": \"Order of listing results, using the sort options Jumia itself offers.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"popularity\",\n        \"newest\",\n        \"lowest-price\",\n        \"highest-price\",\n        \"rating\"\n      ],\n      \"enumTitles\": [\n        \"Popularity\",\n        \"Newest arrivals\",\n        \"Price: low to high\",\n        \"Price: high to low\",\n        \"Product rating\"\n      ],\n      \"default\": \"popularity\",\n      \"prefill\": \"popularity\"\n    },\n    \"minPrice\": {\n      \"title\": \"Minimum price\",\n      \"type\": \"number\",\n      \"description\": \"Lowest price to keep, in the selected market's local currency.\",\n      \"minimum\": 0\n    },\n    \"maxPrice\": {\n      \"title\": \"Maximum price\",\n      \"type\": \"number\",\n      \"description\": \"Highest price to keep, in the selected market's local currency.\",\n      \"minimum\": 0\n    },\n    \"minRating\": {\n      \"title\": \"Minimum rating\",\n      \"type\": \"number\",\n      \"description\": \"Keep products rated at least this many stars (0-5).\",\n      \"minimum\": 0,\n      \"maximum\": 5\n    },\n    \"minDiscount\": {\n      \"title\": \"Minimum discount\",\n      \"type\": \"string\",\n      \"description\": \"Keep products discounted by at least this percentage.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"0\",\n        \"10\",\n        \"20\",\n        \"30\",\n        \"40\",\n        \"50\"\n      ],\n      \"enumTitles\": [\n        \"Any discount\",\n        \"10% or more\",\n        \"20% or more\",\n        \"30% or more\",\n        \"40% or more\",\n        \"50% or more\"\n      ],\n      \"default\": \"0\",\n      \"prefill\": \"0\"\n    },\n    \"minSellerScore\": {\n      \"title\": \"Minimum seller score\",\n      \"type\": \"string\",\n      \"description\": \"Keep products from sellers above a Jumia seller-score band.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"0\",\n        \"1\",\n        \"2\",\n        \"3\",\n        \"4\"\n      ],\n      \"enumTitles\": [\n        \"Any seller\",\n        \"20% or more\",\n        \"40% or more\",\n        \"60% or more\",\n        \"80% or more\"\n      ],\n      \"default\": \"0\",\n      \"prefill\": \"0\"\n    },\n    \"officialStoreOnly\": {\n      \"title\": \"Official stores only\",\n      \"type\": \"boolean\",\n      \"description\": \"Keep products sold by brand-authorised official stores.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"expressOnly\": {\n      \"title\": \"Jumia Express only\",\n      \"type\": \"boolean\",\n      \"description\": \"Keep products fulfilled through Jumia Express.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"condition\": {\n      \"title\": \"Condition\",\n      \"type\": \"string\",\n      \"description\": \"Filter by product condition. Jumia exposes new items, refurbished items and packaging-damaged items through different filters.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"any\",\n        \"new\",\n        \"refurbished\",\n        \"packaging_damaged\"\n      ],\n      \"enumTitles\": [\n        \"Any condition\",\n        \"New\",\n        \"Refurbished\",\n        \"Packaging damaged\"\n      ],\n      \"default\": \"any\",\n      \"prefill\": \"any\"\n    },\n    \"enrichDetails\": {\n      \"title\": \"Add full product details\",\n      \"type\": \"boolean\",\n      \"description\": \"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.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"partitionByPrice\": {\n      \"title\": \"Partition large runs by price\",\n      \"type\": \"boolean\",\n      \"description\": \"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.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"includeReviews\": {\n      \"title\": \"Include full reviews\",\n      \"type\": \"boolean\",\n      \"description\": \"For product detail and enriched listings, read the product's review pages and add them to the record.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"maxReviews\": {\n      \"title\": \"Maximum reviews\",\n      \"type\": \"integer\",\n      \"description\": \"How many customer reviews to include per product when full reviews are enabled.\",\n      \"minimum\": 1,\n      \"maximum\": 100,\n      \"default\": 20,\n      \"prefill\": 20\n    },\n    \"maxItems\": {\n      \"title\": \"Maximum products\",\n      \"type\": \"integer\",\n      \"description\": \"Stop after this many product records. Jumia caps one listing at 2,000 products (50 pages); enable price partitioning to combine bands.\",\n      \"minimum\": 1,\n      \"maximum\": 10000,\n      \"default\": 40,\n      \"prefill\": 40\n    },\n    \"maxPages\": {\n      \"title\": \"Maximum listing pages\",\n      \"type\": \"integer\",\n      \"description\": \"How many listing pages to read, about 40 products per page. Jumia shows at most 50 pages for one listing.\",\n      \"minimum\": 1,\n      \"maximum\": 50,\n      \"default\": 5,\n      \"prefill\": 5\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# Jumia Marketplace Catalog, Seller & Deal Extractor\r\n\r\nJumia 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.\r\n\r\nIt is built for price monitoring, assortment research, seller discovery and cross-market comparison. No login, cookie or API key is needed.\r\n\r\n## Active storefronts\r\n\r\nThe actor covers the eight Jumia retail storefronts that currently serve a catalogue:\r\n\r\n| Storefront | Domain | Currency |\r\n|---|---|---|\r\n| Nigeria | jumia.com.ng | NGN |\r\n| Kenya | jumia.co.ke | KES |\r\n| Ghana | jumia.com.gh | GHS |\r\n| Egypt | jumia.com.eg | EGP |\r\n| Morocco | jumia.ma | MAD |\r\n| Senegal | jumia.sn | XOF |\r\n| Uganda | jumia.ug | UGX |\r\n| Côte d'Ivoire | jumia.ci | XOF |\r\n\r\nSouth 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.\r\n\r\n## Modes\r\n\r\n- **Search by keyword** — reads the normal Jumia search listing for the chosen market.\r\n- **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.\r\n- **Today's flash deals** — reads `/flash-sales/`, where Jumia publishes its current time-limited offers.\r\n- **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.\r\n- **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.\r\n- **Brand page** — reads `/brands/<brand>/` or a category-plus-brand page, with optional keyword narrowing.\r\n\r\nSearch, category, flash, seller and brand modes share the same listing engine, filters, sort options and pagination.\r\n\r\n## What each record contains\r\n\r\nEvery 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.\r\n\r\n| Field | Meaning |\r\n|---|---|\r\n| `productId` | Product identifier taken from the product URL |\r\n| `productIdNumeric` | Numeric product id at the end of the URL, when present |\r\n| `sku` | Jumia config SKU, the stable key across markets |\r\n| `name` | Product title |\r\n| `brand` | Brand shown by Jumia |\r\n| `price` | Current price in the market's local currency |\r\n| `originalPrice` | Price before the current discount, when Jumia shows one |\r\n| `discountRate` | Discount percentage |\r\n| `rating` | Star rating, 0–5 |\r\n| `reviewCount` | Number of ratings or reviews Jumia reports |\r\n| `imageUrl` | Main product image |\r\n| `imageUrls` | Gallery images when the product page exposes more than one |\r\n| `productUrl` | Canonical product page URL |\r\n| `seller` | Seller name, from the product page |\r\n| `sellerId` | Jumia seller id, from a listing card or product page |\r\n| `sellerUrl` | Seller storefront URL, when Jumia provides one |\r\n| `sellerScore` | Seller score percentage |\r\n| `sellerFollowers` | Follower count |\r\n| `sellerPerformance` | Shipping speed, quality score, customer rating and cancellation rate labels |\r\n| `categoryPath` | Category path shown on a listing card |\r\n| `categories` | Category breadcrumb as a list |\r\n| `category` | Leaf category, from the product breadcrumb |\r\n| `breadcrumbs` | Breadcrumb names and URLs |\r\n| `availability` | `InStock`, `OutOfStock` or `PreOrder` |\r\n| `stockCount` | Units in stock when Jumia publishes a number |\r\n| `condition` | `new`, `refurbished`, `used` or `packaging_damaged` |\r\n| `isExpress` | Product is fulfilled through Jumia Express |\r\n| `isOfficialStore` | Product is sold by an official brand store |\r\n| `promotion` | Promotion or coupon label |\r\n| `campaignBadge` | Campaign badge shown on the card |\r\n| `position` | Position in the listing page |\r\n| `inStock` | Stock signal from the listing card |\r\n| `warranty` | Warranty text |\r\n| `returnPolicy` | Return policy text |\r\n| `returnDays` | Return window in days |\r\n| `shippingFrom` | Lowest shipping price shown |\r\n| `deliveryFees` | Delivery fee shown |\r\n| `description` | Full description, product-detail records only |\r\n| `specifications` | Key/value specification object, when Jumia exposes one |\r\n| `shopType` | For example `Jumia Mall` |\r\n| `gtin` | GTIN/barcode when present |\r\n| `keyFeatures` | Bullet features |\r\n| `inTheBox` | Pack contents |\r\n| `topReviews` | Up to three recent reviews from the product page |\r\n| `variants` | Simple variations with SKU, name, price, stock and selection state, when Jumia publishes them |\r\n| `selectedVariantSku` | SKU of the selected simple variation |\r\n| `isBuyable` | Jumia marks the product buyable |\r\n| `reviews` | Full review rows when full reviews are enabled |\r\n| `country` | Market TLD, for example `ng` |\r\n| `countryName` | Readable market name |\r\n| `currency` | ISO currency code |\r\n| `recordType` | Always `product` |\r\n| `scrapedAt` | UTC collection timestamp |\r\n| `sourceUrl` | The listing or product page the row came from |\r\n\r\nEmpty values are omitted at every level. Numbers and booleans such as `0` and `false` are preserved when they are real values.\r\n\r\n## Input\r\n\r\n| Field | Type | Default | Description |\r\n|---|---|---|---|\r\n| `mode` | string | `search` | `search`, `categoryBrowse`, `flashSales`, `productDetails`, `sellerProducts` or `brandProducts`. |\r\n| `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. |\r\n| `keyword` | string | – | Search words. The form is prefilled with `smartphone`; it also narrows brand searches when set. |\r\n| `categorySlug` | string | – | Friendly key, local path or full category URL. Used by category and brand modes. |\r\n| `productUrls` | array | `[]` | Product page URLs for `productDetails`. |\r\n| `sellerUrls` | array | `[]` | Seller storefront URLs or slugs for `sellerProducts`. |\r\n| `brand` | string | – | Brand name, slug or URL for `brandProducts`, or to narrow search/category results. |\r\n| `sort` | string | `popularity` | `popularity`, `newest`, `lowest-price`, `highest-price` or `rating`. |\r\n| `minPrice` | number | – | Lowest local price to keep. |\r\n| `maxPrice` | number | – | Highest local price to keep. |\r\n| `minRating` | number | – | Keep products rated at least this many stars (0–5). |\r\n| `minDiscount` | integer | `0` | Keep products discounted by at least 0, 10, 20, 30, 40 or 50 percent. |\r\n| `minSellerScore` | integer | `0` | Keep sellers in the 20, 40, 60 or 80 percent band and above. |\r\n| `officialStoreOnly` | boolean | `false` | Keep official-store products only. |\r\n| `expressOnly` | boolean | `false` | Keep Jumia Express products only. |\r\n| `condition` | string | `any` | `any`, `new`, `refurbished` or `packaging_damaged`. |\r\n| `enrichDetails` | boolean | `false` | Open each listing product to add description, specifications, seller score and product-page extras. |\r\n| `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. |\r\n| `includeReviews` | boolean | `false` | Read full review pages for product-detail and enriched records. |\r\n| `maxReviews` | integer | `20` | Reviews per product when full reviews are enabled. |\r\n| `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. |\r\n| `maxPages` | integer | `5` | Listing pages to read, about 40 products each. Jumia shows at most 50 pages. |\r\n\r\n## Examples\r\n\r\n### Search a market\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"country\": \"kenya\",\r\n  \"keyword\": \"laptop\",\r\n  \"sort\": \"lowest-price\",\r\n  \"minRating\": 4,\r\n  \"maxItems\": 80\r\n}\r\n```\r\n\r\n### Browse a category with filters\r\n\r\n```json\r\n{\r\n  \"mode\": \"categoryBrowse\",\r\n  \"country\": \"morocco\",\r\n  \"categorySlug\": \"phones-tablets\",\r\n  \"minPrice\": 1000,\r\n  \"maxPrice\": 5000,\r\n  \"minDiscount\": 20,\r\n  \"officialStoreOnly\": true,\r\n  \"maxItems\": 120\r\n}\r\n```\r\n\r\n### Read a brand page\r\n\r\n```json\r\n{\r\n  \"mode\": \"brandProducts\",\r\n  \"country\": \"nigeria\",\r\n  \"brand\": \"samsung\",\r\n  \"categorySlug\": \"phones-tablets\",\r\n  \"maxItems\": 100\r\n}\r\n```\r\n\r\n### Read a seller storefront\r\n\r\n```json\r\n{\r\n  \"mode\": \"sellerProducts\",\r\n  \"country\": \"ghana\",\r\n  \"sellerUrls\": [\"https://www.jumia.com.gh/his-majesty-phones-limited-ca/\"],\r\n  \"enrichDetails\": true,\r\n  \"maxItems\": 60\r\n}\r\n```\r\n\r\n### Full details for product URLs\r\n\r\n```json\r\n{\r\n  \"mode\": \"productDetails\",\r\n  \"productUrls\": [\r\n    \"https://www.jumia.com.ng/samsung-galaxy-a06-6.7-4gb-ram128gb-rom-android-14-black-401614264.html\"\r\n  ]\r\n}\r\n```\r\n\r\n## How it works\r\n\r\nJumia 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.\r\n\r\nCloudflare 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.\r\n\r\n## FAQ\r\n\r\n**Do I need a proxy or cookies?**\r\nNo. The actor works without either. If Jumia blocks a direct request, the actor retries and then uses Apify's automatic proxy pool.\r\n\r\n**Why only eight countries?**\r\nThose 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.\r\n\r\n**How many products can one listing return?**\r\nJumia 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.\r\n\r\n**What is the difference between `price` and `originalPrice`?**\r\n`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.\r\n\r\n**Why are some fields missing?**\r\nJumia 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.\r\n\r\n**Can I mix markets in one run?**\r\nYes in `productDetails` and `sellerProducts`, because the market is read from each URL. Keyword, category, flash and brand modes use the selected `country`.\r\n\r\n**Are old saved tasks still supported?**\r\nThe 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.\r\n\r\n**How do I get more than 2,000 products?**\r\nRequests 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.\r\n\r\n**Can I get every review?**\r\nSet `includeReviews` to true and choose `maxReviews`. Review pages are read in order; `topReviews` remains the three-review summary.\r\n\r\n**Does the actor keep price history?**\r\nNo. Jumia publishes the current and struck-through price, not a history. Schedule reruns and compare `price` by `sku` over time.\r\n\r\n**Is this affiliated with Jumia?**\r\nNo. This actor reads public Jumia pages and is not affiliated with, endorsed by, or connected to Jumia.\r\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "jumia-africa-catalog-and-flash-deals-extractor",
      "title": "Jumia Marketplace Catalog, Seller & Deal Extractor",
      "description": "Collect Jumia products by keyword, category, flash deal, seller storefront or brand page across eight active African storefronts. Returns local prices, discounts, ratings, seller identity, stock signals, categories and optional full product details.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# Jumia Marketplace Catalog, Seller & Deal Extractor\r\n\r\nJumia 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.\r\n\r\nIt is built for price monitoring, assortment research, seller discovery and cross-market comparison. No login, cookie or API key is needed.\r\n\r\n## Active storefronts\r\n\r\nThe actor covers the eight Jumia retail storefronts that currently serve a catalogue:\r\n\r\n| Storefront | Domain | Currency |\r\n|---|---|---|\r\n| Nigeria | jumia.com.ng | NGN |\r\n| Kenya | jumia.co.ke | KES |\r\n| Ghana | jumia.com.gh | GHS |\r\n| Egypt | jumia.com.eg | EGP |\r\n| Morocco | jumia.ma | MAD |\r\n| Senegal | jumia.sn | XOF |\r\n| Uganda | jumia.ug | UGX |\r\n| Côte d'Ivoire | jumia.ci | XOF |\r\n\r\nSouth 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.\r\n\r\n## Modes\r\n\r\n- **Search by keyword** — reads the normal Jumia search listing for the chosen market.\r\n- **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.\r\n- **Today's flash deals** — reads `/flash-sales/`, where Jumia publishes its current time-limited offers.\r\n- **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.\r\n- **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.\r\n- **Brand page** — reads `/brands/<brand>/` or a category-plus-brand page, with optional keyword narrowing.\r\n\r\nSearch, category, flash, seller and brand modes share the same listing engine, filters, sort options and pagination.\r\n\r\n## What each record contains\r\n\r\nEvery 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.\r\n\r\n| Field | Meaning |\r\n|---|---|\r\n| `productId` | Product identifier taken from the product URL |\r\n| `productIdNumeric` | Numeric product id at the end of the URL, when present |\r\n| `sku` | Jumia config SKU, the stable key across markets |\r\n| `name` | Product title |\r\n| `brand` | Brand shown by Jumia |\r\n| `price` | Current price in the market's local currency |\r\n| `originalPrice` | Price before the current discount, when Jumia shows one |\r\n| `discountRate` | Discount percentage |\r\n| `rating` | Star rating, 0–5 |\r\n| `reviewCount` | Number of ratings or reviews Jumia reports |\r\n| `imageUrl` | Main product image |\r\n| `imageUrls` | Gallery images when the product page exposes more than one |\r\n| `productUrl` | Canonical product page URL |\r\n| `seller` | Seller name, from the product page |\r\n| `sellerId` | Jumia seller id, from a listing card or product page |\r\n| `sellerUrl` | Seller storefront URL, when Jumia provides one |\r\n| `sellerScore` | Seller score percentage |\r\n| `sellerFollowers` | Follower count |\r\n| `sellerPerformance` | Shipping speed, quality score, customer rating and cancellation rate labels |\r\n| `categoryPath` | Category path shown on a listing card |\r\n| `categories` | Category breadcrumb as a list |\r\n| `category` | Leaf category, from the product breadcrumb |\r\n| `breadcrumbs` | Breadcrumb names and URLs |\r\n| `availability` | `InStock`, `OutOfStock` or `PreOrder` |\r\n| `stockCount` | Units in stock when Jumia publishes a number |\r\n| `condition` | `new`, `refurbished`, `used` or `packaging_damaged` |\r\n| `isExpress` | Product is fulfilled through Jumia Express |\r\n| `isOfficialStore` | Product is sold by an official brand store |\r\n| `promotion` | Promotion or coupon label |\r\n| `campaignBadge` | Campaign badge shown on the card |\r\n| `position` | Position in the listing page |\r\n| `inStock` | Stock signal from the listing card |\r\n| `warranty` | Warranty text |\r\n| `returnPolicy` | Return policy text |\r\n| `returnDays` | Return window in days |\r\n| `shippingFrom` | Lowest shipping price shown |\r\n| `deliveryFees` | Delivery fee shown |\r\n| `description` | Full description, product-detail records only |\r\n| `specifications` | Key/value specification object, when Jumia exposes one |\r\n| `shopType` | For example `Jumia Mall` |\r\n| `gtin` | GTIN/barcode when present |\r\n| `keyFeatures` | Bullet features |\r\n| `inTheBox` | Pack contents |\r\n| `topReviews` | Up to three recent reviews from the product page |\r\n| `variants` | Simple variations with SKU, name, price, stock and selection state, when Jumia publishes them |\r\n| `selectedVariantSku` | SKU of the selected simple variation |\r\n| `isBuyable` | Jumia marks the product buyable |\r\n| `reviews` | Full review rows when full reviews are enabled |\r\n| `country` | Market TLD, for example `ng` |\r\n| `countryName` | Readable market name |\r\n| `currency` | ISO currency code |\r\n| `recordType` | Always `product` |\r\n| `scrapedAt` | UTC collection timestamp |\r\n| `sourceUrl` | The listing or product page the row came from |\r\n\r\nEmpty values are omitted at every level. Numbers and booleans such as `0` and `false` are preserved when they are real values.\r\n\r\n## Input\r\n\r\n| Field | Type | Default | Description |\r\n|---|---|---|---|\r\n| `mode` | string | `search` | `search`, `categoryBrowse`, `flashSales`, `productDetails`, `sellerProducts` or `brandProducts`. |\r\n| `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. |\r\n| `keyword` | string | – | Search words. The form is prefilled with `smartphone`; it also narrows brand searches when set. |\r\n| `categorySlug` | string | – | Friendly key, local path or full category URL. Used by category and brand modes. |\r\n| `productUrls` | array | `[]` | Product page URLs for `productDetails`. |\r\n| `sellerUrls` | array | `[]` | Seller storefront URLs or slugs for `sellerProducts`. |\r\n| `brand` | string | – | Brand name, slug or URL for `brandProducts`, or to narrow search/category results. |\r\n| `sort` | string | `popularity` | `popularity`, `newest`, `lowest-price`, `highest-price` or `rating`. |\r\n| `minPrice` | number | – | Lowest local price to keep. |\r\n| `maxPrice` | number | – | Highest local price to keep. |\r\n| `minRating` | number | – | Keep products rated at least this many stars (0–5). |\r\n| `minDiscount` | integer | `0` | Keep products discounted by at least 0, 10, 20, 30, 40 or 50 percent. |\r\n| `minSellerScore` | integer | `0` | Keep sellers in the 20, 40, 60 or 80 percent band and above. |\r\n| `officialStoreOnly` | boolean | `false` | Keep official-store products only. |\r\n| `expressOnly` | boolean | `false` | Keep Jumia Express products only. |\r\n| `condition` | string | `any` | `any`, `new`, `refurbished` or `packaging_damaged`. |\r\n| `enrichDetails` | boolean | `false` | Open each listing product to add description, specifications, seller score and product-page extras. |\r\n| `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. |\r\n| `includeReviews` | boolean | `false` | Read full review pages for product-detail and enriched records. |\r\n| `maxReviews` | integer | `20` | Reviews per product when full reviews are enabled. |\r\n| `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. |\r\n| `maxPages` | integer | `5` | Listing pages to read, about 40 products each. Jumia shows at most 50 pages. |\r\n\r\n## Examples\r\n\r\n### Search a market\r\n\r\n```json\r\n{\r\n  \"mode\": \"search\",\r\n  \"country\": \"kenya\",\r\n  \"keyword\": \"laptop\",\r\n  \"sort\": \"lowest-price\",\r\n  \"minRating\": 4,\r\n  \"maxItems\": 80\r\n}\r\n```\r\n\r\n### Browse a category with filters\r\n\r\n```json\r\n{\r\n  \"mode\": \"categoryBrowse\",\r\n  \"country\": \"morocco\",\r\n  \"categorySlug\": \"phones-tablets\",\r\n  \"minPrice\": 1000,\r\n  \"maxPrice\": 5000,\r\n  \"minDiscount\": 20,\r\n  \"officialStoreOnly\": true,\r\n  \"maxItems\": 120\r\n}\r\n```\r\n\r\n### Read a brand page\r\n\r\n```json\r\n{\r\n  \"mode\": \"brandProducts\",\r\n  \"country\": \"nigeria\",\r\n  \"brand\": \"samsung\",\r\n  \"categorySlug\": \"phones-tablets\",\r\n  \"maxItems\": 100\r\n}\r\n```\r\n\r\n### Read a seller storefront\r\n\r\n```json\r\n{\r\n  \"mode\": \"sellerProducts\",\r\n  \"country\": \"ghana\",\r\n  \"sellerUrls\": [\"https://www.jumia.com.gh/his-majesty-phones-limited-ca/\"],\r\n  \"enrichDetails\": true,\r\n  \"maxItems\": 60\r\n}\r\n```\r\n\r\n### Full details for product URLs\r\n\r\n```json\r\n{\r\n  \"mode\": \"productDetails\",\r\n  \"productUrls\": [\r\n    \"https://www.jumia.com.ng/samsung-galaxy-a06-6.7-4gb-ram128gb-rom-android-14-black-401614264.html\"\r\n  ]\r\n}\r\n```\r\n\r\n## How it works\r\n\r\nJumia 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.\r\n\r\nCloudflare 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.\r\n\r\n## FAQ\r\n\r\n**Do I need a proxy or cookies?**\r\nNo. The actor works without either. If Jumia blocks a direct request, the actor retries and then uses Apify's automatic proxy pool.\r\n\r\n**Why only eight countries?**\r\nThose 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.\r\n\r\n**How many products can one listing return?**\r\nJumia 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.\r\n\r\n**What is the difference between `price` and `originalPrice`?**\r\n`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.\r\n\r\n**Why are some fields missing?**\r\nJumia 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.\r\n\r\n**Can I mix markets in one run?**\r\nYes in `productDetails` and `sellerProducts`, because the market is read from each URL. Keyword, category, flash and brand modes use the selected `country`.\r\n\r\n**Are old saved tasks still supported?**\r\nThe 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.\r\n\r\n**How do I get more than 2,000 products?**\r\nRequests 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.\r\n\r\n**Can I get every review?**\r\nSet `includeReviews` to true and choose `maxReviews`. Review pages are read in order; `topReviews` remains the three-review summary.\r\n\r\n**Does the actor keep price history?**\r\nNo. Jumia publishes the current and struck-through price, not a history. Schedule reruns and compare `price` by `sku` over time.\r\n\r\n**Is this affiliated with Jumia?**\r\nNo. This actor reads public Jumia pages and is not affiliated with, endorsed by, or connected to Jumia.\r\n",
      "input": {
        "title": "Jumia marketplace input",
        "description": "Choose a Jumia storefront and a way to collect products: keyword search, category, flash deals, product URLs, seller storefronts, or brand pages.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Collection mode",
            "type": "string",
            "description": "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.",
            "editor": "select",
            "enum": [
              "search",
              "categoryBrowse",
              "flashSales",
              "productDetails",
              "sellerProducts",
              "brandProducts"
            ],
            "enumTitles": [
              "Search by keyword",
              "Browse a category",
              "Today's flash deals",
              "Specific product URLs",
              "Seller storefront",
              "Brand page"
            ],
            "default": "search",
            "prefill": "search"
          },
          "country": {
            "title": "Jumia storefront",
            "type": "string",
            "description": "The active Jumia country storefront to use. Prices are returned in that market's local currency.",
            "editor": "select",
            "enum": [
              "nigeria",
              "kenya",
              "ghana",
              "egypt",
              "morocco",
              "senegal",
              "uganda",
              "cote_divoire",
              "south_africa",
              "cameroon",
              "tanzania"
            ],
            "enumTitles": [
              "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)",
              "Cote d'Ivoire - jumia.ci (XOF)",
              "South Africa - closed, no retail storefront",
              "Cameroon - closed, no retail storefront",
              "Tanzania - closed, no retail storefront"
            ],
            "default": "nigeria",
            "prefill": "nigeria"
          },
          "keyword": {
            "title": "Keyword",
            "type": "string",
            "description": "Product words to search for. Also narrows brand listings when set.",
            "editor": "textfield",
            "default": "",
            "prefill": "smartphone"
          },
          "categorySlug": {
            "title": "Category",
            "type": "string",
            "description": "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.",
            "editor": "textfield"
          },
          "productUrls": {
            "title": "Product URLs",
            "type": "array",
            "description": "Jumia product page URLs for the specific product mode. The market is detected from each URL.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "sellerUrls": {
            "title": "Seller URLs or slugs",
            "type": "array",
            "description": "Seller storefront URLs (or slugs like 'jckm-cod') for the seller mode. A full seller profile URL is accepted too.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "brand": {
            "title": "Brand",
            "type": "string",
            "description": "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/.",
            "editor": "textfield"
          },
          "sort": {
            "title": "Sort order",
            "type": "string",
            "description": "Order of listing results, using the sort options Jumia itself offers.",
            "editor": "select",
            "enum": [
              "popularity",
              "newest",
              "lowest-price",
              "highest-price",
              "rating"
            ],
            "enumTitles": [
              "Popularity",
              "Newest arrivals",
              "Price: low to high",
              "Price: high to low",
              "Product rating"
            ],
            "default": "popularity",
            "prefill": "popularity"
          },
          "minPrice": {
            "title": "Minimum price",
            "type": "number",
            "description": "Lowest price to keep, in the selected market's local currency.",
            "minimum": 0
          },
          "maxPrice": {
            "title": "Maximum price",
            "type": "number",
            "description": "Highest price to keep, in the selected market's local currency.",
            "minimum": 0
          },
          "minRating": {
            "title": "Minimum rating",
            "type": "number",
            "description": "Keep products rated at least this many stars (0-5).",
            "minimum": 0,
            "maximum": 5
          },
          "minDiscount": {
            "title": "Minimum discount",
            "type": "string",
            "description": "Keep products discounted by at least this percentage.",
            "editor": "select",
            "enum": [
              "0",
              "10",
              "20",
              "30",
              "40",
              "50"
            ],
            "enumTitles": [
              "Any discount",
              "10% or more",
              "20% or more",
              "30% or more",
              "40% or more",
              "50% or more"
            ],
            "default": "0",
            "prefill": "0"
          },
          "minSellerScore": {
            "title": "Minimum seller score",
            "type": "string",
            "description": "Keep products from sellers above a Jumia seller-score band.",
            "editor": "select",
            "enum": [
              "0",
              "1",
              "2",
              "3",
              "4"
            ],
            "enumTitles": [
              "Any seller",
              "20% or more",
              "40% or more",
              "60% or more",
              "80% or more"
            ],
            "default": "0",
            "prefill": "0"
          },
          "officialStoreOnly": {
            "title": "Official stores only",
            "type": "boolean",
            "description": "Keep products sold by brand-authorised official stores.",
            "default": false,
            "prefill": false
          },
          "expressOnly": {
            "title": "Jumia Express only",
            "type": "boolean",
            "description": "Keep products fulfilled through Jumia Express.",
            "default": false,
            "prefill": false
          },
          "condition": {
            "title": "Condition",
            "type": "string",
            "description": "Filter by product condition. Jumia exposes new items, refurbished items and packaging-damaged items through different filters.",
            "editor": "select",
            "enum": [
              "any",
              "new",
              "refurbished",
              "packaging_damaged"
            ],
            "enumTitles": [
              "Any condition",
              "New",
              "Refurbished",
              "Packaging damaged"
            ],
            "default": "any",
            "prefill": "any"
          },
          "enrichDetails": {
            "title": "Add full product details",
            "type": "boolean",
            "description": "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.",
            "default": false,
            "prefill": false
          },
          "partitionByPrice": {
            "title": "Partition large runs by price",
            "type": "boolean",
            "description": "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.",
            "default": false,
            "prefill": false
          },
          "includeReviews": {
            "title": "Include full reviews",
            "type": "boolean",
            "description": "For product detail and enriched listings, read the product's review pages and add them to the record.",
            "default": false,
            "prefill": false
          },
          "maxReviews": {
            "title": "Maximum reviews",
            "type": "integer",
            "description": "How many customer reviews to include per product when full reviews are enabled.",
            "minimum": 1,
            "maximum": 100,
            "default": 20,
            "prefill": 20
          },
          "maxItems": {
            "title": "Maximum products",
            "type": "integer",
            "description": "Stop after this many product records. Jumia caps one listing at 2,000 products (50 pages); enable price partitioning to combine bands.",
            "minimum": 1,
            "maximum": 10000,
            "default": 40,
            "prefill": 40
          },
          "maxPages": {
            "title": "Maximum listing pages",
            "type": "integer",
            "description": "How many listing pages to read, about 40 products per page. Jumia shows at most 50 pages for one listing.",
            "minimum": 1,
            "maximum": 50,
            "default": 5,
            "prefill": 5
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Jumia Marketplace Catalog, Seller & Deal Extractor output",
        "description": "Jumia product records with local price and currency, discount, rating, review count, seller identity and score, stock signal, categories, images, product URL, optional variants, full reviews, description, specifications and warranty.",
        "properties": {
          "products": {
            "type": "string",
            "title": "Jumia products",
            "description": "Dataset containing one record per Jumia product, with listing-only fields or full product-page details depending on the selected mode.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Products",
              "transformation": {
                "fields": [
                  "name",
                  "price",
                  "currency",
                  "discountRate",
                  "rating",
                  "brand",
                  "seller",
                  "country",
                  "availability",
                  "productUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            },
            "details": {
              "title": "Product details",
              "transformation": {
                "fields": [
                  "productId",
                  "sku",
                  "name",
                  "brand",
                  "seller",
                  "sellerScore",
                  "sellerFollowers",
                  "price",
                  "originalPrice",
                  "discountRate",
                  "rating",
                  "reviewCount",
                  "availability",
                  "stockCount",
                  "condition",
                  "warranty",
                  "returnDays",
                  "categories",
                  "currency",
                  "productUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.2",
    "imageDigest": "2133f41dcd049bac4417906bc73dca02be812845ba93968751dbd487e05802ce",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.024383333333333333
    }
  }
}