# Konga Scraper — Nigeria Marketplace Products & Prices (`logiover/konga-scraper`) Actor

Konga Scraper turns Nigeria's largest online marketplace into structured product data. Search any keyword and export the product name, brand, the current and discounted naira price, the full product description, the seller/store with its city and state, stock status, star rating and the number of un

- **URL**: https://apify.com/logiover/konga-scraper.md
- **Developed by:** [Logiover](https://apify.com/logiover) (community)
- **Categories:** E-commerce, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 1,000 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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## 🇳🇬 Konga Scraper — Nigeria Marketplace Products & Prices

> **Export Konga.com products by search term — name, brand, naira price, seller with city, ratings and units sold — to JSON, CSV or Excel. Keyless, deep pagination.**

![data](https://img.shields.io/badge/data-JSON%C2%B7CSV%C2%B7Excel-2b8a3e?style=flat-square) ![login](https://img.shields.io/badge/login-not%20required-0b7285?style=flat-square) ![pricing](https://img.shields.io/badge/pricing-pay%20per%20result-5f3dc4?style=flat-square)

**Konga Scraper** turns Nigeria's largest online marketplace into structured product data. Search any keyword and export the product name, brand, the current and discounted **naira price**, the full product description, the seller/store with its **city and state**, stock status, star rating and the number of **units already sold**. It reads Konga's own search API, so pagination is deep — thousands of products per query, not just page one. A no-code Konga API alternative on Apify.

### 📋 At a glance

| | |
|---|---|
| **Source** | konga.com (Nigeria #1 marketplace) |
| **Method** | Official search API (deep pagination) |
| **Volume** | Thousands per query (e.g. 4,000+ for "phone") |
| **Seller data** | Store name + city + state + official flag |
| **Prices** | NGN + special + deal price |
| **Signals** | Rating · units sold · in-stock |
| **Output** | JSON, CSV, Excel |
| **Login** | Not required |

### ❓ What is Konga Scraper?

Konga is one of Nigeria's leading e-commerce platforms. Its storefront paginates search results through a public search API — the server-rendered HTML only ever carries the first 40 products. This scraper calls that API directly, so every product comes out fully typed and pagination runs deep: name, brand, list/special/deal price in naira, the full description text, the seller/store with its city and state, stock and units-sold counters, and the star rating with review count.

### ⭐ Why use this scraper?

- ✅ **Deep pagination** — thousands of products per keyword, never page-one only
- ✅ **Real description text**, list price, special price and deal price as columns
- ✅ **Seller store name plus city and state** — geographic B2B lead data
- ✅ **Units sold and rating** — built-in demand and quality signals
- ✅ **Official-store and fulfilment flags** for filtering
- ✅ **Keyless, no proxy required** — fast and low cost per row

### 📦 What data can you extract?

| Field | Description |
|---|---|
| `productId` | Product SKU |
| `name` | Product name |
| `brand` | Brand |
| `priceNgn` | Price (NGN) |
| `specialPriceNgn` | Special price (NGN) |
| `dealPriceNgn` | Deal price (NGN) |
| `productUrl` | Product URL |
| `imageUrl` | Image |
| `description` | Description |
| `sellerName` | Seller / store |
| `sellerId` | Seller ID |
| `sellerCity` | Seller city |
| `sellerState` | Seller state |
| `officialStore` | Official store |
| `fulfilmentType` | Fulfilment type |
| `inStock` | In stock |
| `quantityAvailable` | Qty available |
| `quantitySold` | Units sold |
| `ratingAverage` | Rating |
| `ratingCount` | Rating count |
| `expressDelivery` | Express delivery |
| `freeShipping` | Free shipping |
| `payOnDelivery` | Pay on delivery |
| `country` | Country |
| `source` | Source |
| `scrapedAt` | Scraped at |

### 🎯 Use cases

- Track competitor pricing and discounts across Konga
- Find best-selling products by units-sold in any keyword
- Build a Nigerian seller/store lead list with city and state
- Monitor stock availability and rating trends over time
- Feed a price-intelligence or e-commerce analytics tool with a Nigeria feed

### 🚀 How to use it

1. Enter a **search term** (e.g. `phone`, `generator`, `laptop`).
2. Optionally add a **filter** or **sort** (advanced), set **Maximum results** and click **Start**.
3. Export to JSON, CSV or Excel, or pull via the Apify API.

#### Input example

```json
{
  "searchTerm": "phone",
  "maxResults": 1000
}
```

### 💳 Pricing

Runs on a **pay-per-result** model with **Apify Store volume discounts** — higher plan tiers pay less per row and you only pay for records delivered. A **free tier** is available to try it, no credit card required.

### ⚖️ Legal

This scraper collects **publicly available** listing data only; nothing behind a login. You remain responsible for how you use the exported data, including any personal data, under GDPR and local law.

### ❔ FAQ

<details>
<summary><b>Do I need a Konga account or API key?</b></summary>

No. The Actor uses Konga's public search API — no login, no key, no proxy required.

</details>

<details>
<summary><b>How many products can I get?</b></summary>

Thousands per keyword — popular terms return 4,000+ products, and the Actor paginates until your Maximum results is met.

</details>

<details>
<summary><b>Do I get the seller location?</b></summary>

Yes — each row includes the store name plus its city and state, useful for B2B lead lists.

</details>

<details>
<summary><b>What is 'units sold'?</b></summary>

Konga publishes a running quantity-sold counter per product; it is exported as a number, a handy demand signal.

</details>

<details>
<summary><b>Can I filter or sort?</b></summary>

Yes — optional advanced fields accept a filter (e.g. `brand:=Samsung`) and a sort (e.g. `price:asc`).

</details>

<details>
<summary><b>How am I charged?</b></summary>

Pay per result — you only pay for the products delivered.

</details>

***

<sub>Keywords: konga scraper, konga api, scrape konga, nigeria ecommerce data, konga products, nigeria marketplace data, konga price tracker, nigeria seller leads, konga product data, konga seller list</sub>

# Actor input Schema

## `searchTerm` (type: `string`):

Keyword to search Konga for, e.g. phone, generator, laptop, refrigerator.

## `filterQuery` (type: `string`):

Optional Typesense-style filter\_by, e.g. brand:=Samsung or price:>50000.

## `sortQuery` (type: `string`):

Optional sort\_by, e.g. price:asc, price:desc, created\_at:desc.

## `maxResults` (type: `integer`):

Stop after this many products; the Actor paginates until met.

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

Optional — the search API works without a proxy. Enable only if you need to route via a specific region.

## Actor input object example

```json
{
  "searchTerm": "phone",
  "maxResults": 500,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `productId` (type: `string`):

No description

## `name` (type: `string`):

No description

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

No description

## `priceNgn` (type: `string`):

No description

## `specialPriceNgn` (type: `string`):

No description

## `dealPriceNgn` (type: `string`):

No description

## `productUrl` (type: `string`):

No description

## `imageUrl` (type: `string`):

No description

## `description` (type: `string`):

No description

## `sellerName` (type: `string`):

No description

## `sellerId` (type: `string`):

No description

## `sellerCity` (type: `string`):

No description

## `sellerState` (type: `string`):

No description

## `officialStore` (type: `string`):

No description

## `fulfilmentType` (type: `string`):

No description

## `inStock` (type: `string`):

No description

## `quantityAvailable` (type: `string`):

No description

## `quantitySold` (type: `string`):

No description

## `ratingAverage` (type: `string`):

No description

## `ratingCount` (type: `string`):

No description

## `expressDelivery` (type: `string`):

No description

## `freeShipping` (type: `string`):

No description

## `payOnDelivery` (type: `string`):

No description

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

No description

## `source` (type: `string`):

No description

## `scrapedAt` (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 = {
    "searchTerm": "phone",
    "maxResults": 500,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("logiover/konga-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 = {
    "searchTerm": "phone",
    "maxResults": 500,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("logiover/konga-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 '{
  "searchTerm": "phone",
  "maxResults": 500,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call logiover/konga-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,logiover/konga-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/HCd8i6ehfncOjYXi8/builds/Pm39DgFjeXUBC4yYd/openapi.json