{ "openapi": "3.0.1", "info": { "title": "Konga Scraper", "description": "Scrape Konga.com - Nigeria's leading online shopping marketplace. Search by keyword or browse Konga's real product categories, filter by price range in NGN, and sort results. Get product names, prices, discounts, ratings, sellers, and images. No login required.", "version": "1.0", "x-build-id": "odYj4CYQndPMjzqfN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~konga-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-konga-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/crawlerbros~konga-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-konga-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/crawlerbros~konga-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-konga-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "browseCategory", "productDetail" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "(mode=search) Keyword to search for. Optional if `category` is also set, in which case it narrows the category browse.", "default": "phone" }, "productUrl": { "title": "Product URL", "type": "string", "description": "(mode=productDetail) A Konga product page URL — e.g. the `productUrl` field from a `search` result, such as `https://www.konga.com/product/some-item-123`." }, "category": { "title": "Category", "enum": [ "Home and Kitchen", "Beauty, Health & Personal Care", "Electronics", "Phones and Tablets", "Power, Automobile & Industrial", "Computers and Accessories", "Konga Fashion", "Books & Media Library", "Baby, Kids and Toys", "Drinks & Groceries", "Sports and Fitness", "Other Categories", "Office & School Supplies", "Yakata", "Deals", "Bulk Products", "Intel Produce Gaming", "Naija Brand", "Samsung Specials" ], "type": "string", "description": "(mode=browseCategory, mode=search) Konga product category (required for mode=browseCategory; optional narrowing filter for mode=search)." }, "priceMinNgn": { "title": "Min price (NGN)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "(mode=search, mode=browseCategory) Only return products priced at or above this amount, in Nigerian Naira." }, "priceMaxNgn": { "title": "Max price (NGN)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "(mode=search, mode=browseCategory) Only return products priced at or below this amount, in Nigerian Naira." }, "sortBy": { "title": "Sort order", "enum": [ "relevance", "priceLowToHigh", "priceHighToLow", "topRated" ], "type": "string", "description": "(mode=search, mode=browseCategory) How to order results.", "default": "relevance" }, "maxItems": { "title": "Max products", "minimum": 1, "maximum": 1000, "type": "integer", "description": "(mode=search, mode=browseCategory) Maximum number of products to return.", "default": 20 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy. The free Apify datacenter proxy (AUTO) works fine; a proxy is not required. Apify's free datacenter pool does not currently offer a Nigeria (NG) country option, so results are not geo-pinned to Nigeria — see the README for details.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }