{ "openapi": "3.0.1", "info": { "title": "Jumia Product Search Scraper", "description": "Automate extraction of product data from Jumia Nigeria's marketplace. Capture SKUs, pricing, ratings, seller information, categories, and images from search results. Perfect for price monitoring, competitor analysis, market research, and inventory intelligence across Nigeria's leading e-commerce.", "version": "0.0", "x-build-id": "ZAqfb17bsD8kUn8Wa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~jumia-product-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-jumia-product-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/stealth_mode~jumia-product-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-jumia-product-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/stealth_mode~jumia-product-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-jumia-product-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "urls": { "title": "URLs of the product search list urls to scrape", "type": "array", "description": "Add the URLs of the product search list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "keyword": { "title": "Keyword to search", "type": "string", "description": "Enter the keyword to search for items" }, "brand": { "title": "Brand to search", "enum": [ "", "abro", "activision", "anker", "apple", "atouch", "bedding-sets", "binatone", "binnys", "bontel", "boombest", "boscon", "canon-ink-cart", "century", "clarks", "clo", "comfortable-garden", "crocs", "curren", "dell", "desubclassic", "djack", "dp", "duravolt", "ea-sports", "fashion", "fashion-cabinet", "forecast", "fragrance-world", "generic", "genetic", "google", "healthcode", "hisense", "holy-bible", "hp", "huawei", "infinix", "ingco", "itel", "jaop", "jbl", "jumia-books", "keep-moving", "kiki-new-gain", "kingskartel", "ladies-everything", "ldnio", "led", "lenovo", "lg", "lighting", "logitech", "lookworld", "master-chef", "mauton", "maxi", "maxmech", "men's", "mobil-1", "mtng", "neo", "new-age", "nokia", "nova", "onibenz", "oppo", "oraimo", "otter-box", "ox", "panasonic", "playstation", "poedagar", "polystar", "pouch", "qasa", "raf", "samsung", "scanfrost", "shplus", "shure", "silver-crest", "skmei", "sokany", "sonik", "sony", "t&g", "tcl", "td", "tecno", "total", "toyota", "tp-link", "trendyol", "ubisoft", "unique", "wmark", "xiaomi", "xundd", "yamaha", "zealot" ], "type": "string", "description": "Enter the brand to search for items" }, "category": { "title": "Category to search", "enum": [ "", "1000-computing", "1492-electronics", "3157-sporting-goods", "6342-patio-lawn-garden", "7221-musical-instruments", "8070-phones-tablets", "8286-toys-games", "9158-category-fashion-by-jumia", "11894-video-games", "12576-home-office", "20696-automobile", "22623-health-beauty", "24527-baby-products", "25122-industrial-scientific", "29459-books-movies-music" ], "type": "string", "description": "Enter the category to search for items" }, "sort_by": { "title": "Sort Items by options", "enum": [ "", "newest", "lowest-price", "highest-price", "rating" ], "type": "string", "description": "Sort items by options" }, "price_range": { "title": "Price range (format: min-max, e.g: 1000-2000)", "type": "string", "description": "Enter the price range to search for items" }, "size": { "title": "Size to search", "enum": [ "", "xs", "s", "m", "m/l", "l", "xl", "xxl", "xxxl", "xxxxl", "00 regular", "1-2 years", "2 years", "2-3 years", "3 years", "3-4 years", "3-6 months", "4 yards", "4 years", "4-5 years", "5 yards", "5 years", "5-6 years", "6 yards", "6 years", "6-7 years", "6-9 months", "7 years", "7-8 years", "8", "8 years", "8-9 years", "9-10 years", "9-12 months", "10", "10 years", "11-12 years", "12-18 months", "18-24 months", "26", "28", "30", "31", "32", "33", "34", "36", "37", "38", "39", "40", "41", "42", "43", "44", "45", "46", "48", "52", "54", "ch 39", "ch 40", "ch 41", "ch 42", "ch 43", "ch 44", "ch 45", "eu 25", "eu 26", "eu 27", "eu 28", "eu 29", "eu 30", "eu 31", "eu 32", "eu 33", "eu 34", "eu 35", "eu 36", "eu 37", "eu 38", "eu 39", "eu 40", "eu 40-41", "eu 41", "eu 42", "eu 43", "eu 44", "eu 45", "eu 46", "eu 47", "not defined", "one size", "one size fits all", "uk 8", "uk 10", "uk 12", "uk 14", "uk 16" ], "type": "string", "description": "Enter the size to search for items" }, "discount": { "title": "Discount", "enum": [ "", "50-100", "40-100", "30-100", "20-100", "10-100" ], "type": "string", "description": "Enter the discount to search for items" }, "page": { "title": "Page start", "type": "integer", "description": "Specify the page number to start scraping from" }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your scraper." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }