Konga API & Scraper
Konga is Nigeria's second-largest online marketplace, with about 458,000 products listed by Konga itself and by marketplace sellers.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
This API reads it as JSON. `search` takes a keyword, a category id, a brand or a seller, with filters for selling-price range, minimum rating, free shipping, pay on delivery, pickup, express delivery and fulfilled by Konga or by the vendor, sorted by relevance or price, up to 100 products per page, plus the site's exact result count. Each row carries the product id, title, brand, URL, image, the price in naira, the previous price and discount when the product is reduced, stock quantity and units sold, the seller's id and name, rating and review count, the delivery flags and the warranty. `product` returns one product in full: description, images, specifications by group, categories, variants (size, colour) each with its own price and stock, order limits, and the seller with its units sold, rating histogram and delivery score. `reviews` returns every customer review the product carries with the star histogram. `seller` returns a marketplace seller's store page and its products, and `categories` the site's category tree with the ids search accepts.
What a Konga field actually contains
Fields that read differently from how they look. Every row was measured against live responses on 2026-10-15.
| Field | What it holds |
|---|---|
| price, price_before_discount, discount_percent | price is what the buyer pays now, in naira (NGN), the same figure the product page prints next to Add to Cart. price_before_discount is the crossed-out price and is only set when the product is reduced; discount_percent is computed from the two, rounded like the site. On 16 products the price matched the product page on 16 of 16 and the crossed-out price on 8 of 8. |
| deal_price | A time-limited deal price when Konga runs one for the product; it is already used as price when present. |
| stock_quantity, quantity_sold | The units Konga reports in stock and the units already sold. For products with sizes or colours the per-variant stock is in variants[].stock_quantity on product; the parent figure can be 0 while variants have stock. |
| seller | The marketplace seller (id, name, store link). The seller action returns the seller's own store page: city and state, official-store flag, how long it has sold on Konga, units sold, delivered orders, delivery score, quality and communication ratings. |
| fulfilled_by | konga when Konga stocks and ships the product from its warehouse, vendor when the seller ships it. |
| free_shipping, pay_on_delivery, pickup_available, express_delivery | The delivery options the site shows on the product. The delivery fee itself is not published per product; Konga computes it at checkout from the delivery address. |
| rating, review_count | The product's average star rating and the number of ratings. Many ratings carry no written comment; reviews returns every rating with its comment when there is one. |
| total | The site's own exact count of products matching the search. On some keywords Konga mixes in promoted products that do not match the filters you set; those rows are removed from results, so a filtered page can hold fewer rows than page_size while total stays the site's figure. |
Prices were compared with each product's own page for 16 products in 8 searches (phones, rice, sneakers, laptops, TVs, diapers, generators): 16 of 16 matched, crossed-out prices 8 of 8. The same id from search returned the same product and price in product on 16 of 16.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/konga/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "iphone"
}
}{
"ok": true,
"meta": {
"api": "konga",
"endpoint": "search",
"mode": "live",
"latency_ms": 2116.6,
"record_count": 40,
"bytes": 35022,
"cache_hit": false,
"upstream_requests": 1,
"total": 4855,
"charged_credits": 2,
"version": "0.1.0",
"request_id": "87100ecd0e084ffe",
"queue_ms": 2.5,
"fetched_at": "2026-10-15T17:02:55.975Z"
},
"data": {
"results": [
{
"product_id": "6060300",
"title": "iPhone 12 Pro Max - 6.7\"-128GB ROM+6GB RAM - Single Sim - 3687mah- Pouch & Screen Protector-Graphite",
"brand": "Apple",
"url": "https://www.konga.com/product/apple-iphone-12-pro-max-6-7-128gb-rom-6gb-ram-single-sim-3687mah-pouch-and-screen-protector-graphite-6060300",
"image": "https://www-konga-com-res.cloudinary.com/media/catalog/product/V/O/163263_1676844425.jpg",
"currency": "NGN",
"price": 629000,
"price_before_discount": null,
"discount_percent": null,
"deal_price": null,
"in_stock": true,
"stock_quantity": 15,
"quantity_sold": 1,
"seller": {
"id": "163263",
"name": "westcoast technology",
"url": "https://www.konga.com/merchant/163263"
},
"rating": null,
"review_count": 0,
"rating_scale": null,
"fulfilled_by": "vendor",
"free_shipping": false,
"pay_on_delivery": true,
"pickup_available": true,
"express_delivery": false,
"official_store": false,
"non_returnable": false,
"product_type": "simple",
"variant_count": null,
"primary_category_id": "7541",
"category_ids": [
"5294",
"5297",
"7539"
]
},
{
"product_id": "6979852",
"title": "Iphone 17 Pro - 256GB ROM - 12 GB RAM - Physical & Esim - 3988 mAh - Orange",
"brand": "Apple",
"url": "https://www.konga.com/product/apple-iphone-17-pro-256gb-rom-12-gb-ram-physical-and-esim-3988-mah-orange-6979852",
"image": "https://www-konga-com-res.cloudinary.com/media/catalog/product/I/V/248775_1778204608.jpg",
"currency": "NGN",
"price": 1989000,
"price_before_discount": null,
"discount_percent": null,
"deal_price": null,
"in_stock": true,
"stock_quantity": 7,
"quantity_sold": 0,
"seller": {
"id": "248775",
"name": "PHONIQ TECH",
"url": "https://www.konga.com/merchant/248775"
},
"rating": null,
"review_count": 0,
"rating_scale": null,
"fulfilled_by": "vendor",
"free_shipping": false,
"pay_on_delivery": true,
"pickup_available": true,
"express_delivery": false,
"official_store": false,
"non_returnable": false,
"product_type": "simple",
"variant_count": null,
"primary_category_id": "10179",
"category_ids": [
"5294",
"5297",
"7539"
]
},
{
"product_id": "7006365",
"title": "Iphone Charging & Power Bank Case, 3200mah Extended Battery Iphone Ix/ixs",
"brand": null,
"url": "https://www.konga.com/product/iphone-charging-and-power-bank-case-3200mah-extended-battery-iphone-ix-ixs-7006365",
"image": "https://www-konga-com-res.cloudinary.com/media/catalog/product/O/W/56319_1782796658.jpg",
"currency": "NGN",
"price": 13500,
"price_before_discount": null,
"discount_percent": null,
"deal_price": null,
"in_stock": true,
"stock_quantity": 4,
"quantity_sold": 1,
"seller": {
"id": "56319",
"name": "jagGed inC",
"url": "https://www.konga.com/merchant/56319"
},
"rating": 3,
"review_count": 1,
"rating_scale": 5,
"fulfilled_by": "konga",
"free_shipping": false,
"pay_on_delivery": true,
"pickup_available": true,
"express_delivery": false,
"official_store": false,
"non_returnable": false,
"product_type": "simple",
"variant_count": null,
"primary_category_id": "5346",
"category_ids": [
"5294",
"5296",
"5338"
]
}
],
"total": 4855,
"page": 1,
"page_size": 40,
"last_page": 122,
"has_more": true,
"beyond_last_page": false,
"currency": "NGN",
"query": "iphone",
"sort": "relevance",
"filters_applied": {}
}
}What the Konga API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Konga (konga.com, Nigeria) by keyword and/or category, brand or seller, with price range (on the selling price), minimum rating, free shipping, pay on delivery, pickup, express delivery and fulfilled-by-Konga / by-vendor filters, sorted by relevance or price. Each row: product id, title, brand, URL, image, price in NGN, previous price and discount when the product is reduced, stock and units sold, seller id and name, rating and review count, delivery flags. Plus the source's own exact total. One of `query`, `category_id`, `brand` or `seller_id` is required. | Pricing teams call search to search Konga (konga.com, Nigeria) by keyword and/or category, brand or seller, with price ran…. | query, category_id, brand, seller_id, min_price, ... |
| product | Full record of one Konga product: title, brand, description, images, selling price in NGN, previous price and discount, stock, units sold, order limits, seller with its sales and ratings, fulfilled by Konga or the vendor, free shipping / pay on delivery / pickup / express delivery, warranty, rating histogram, review count, specifications by group, categories, variants (size / colour) each with its own price and stock. | Marketplace operators call product to get full record of one Konga product. | product_id |
| reviews | Customer reviews of one Konga product: average rating, review count, the 5-to-1 star histogram and every review the product carries (star rating, comment when written, reviewer display name, date, seller), newest first. | Catalog enrichment teams call reviews to get customer reviews of one Konga product. | product_id |
| seller | A Konga marketplace seller's store: name, city and state, official-store flag, how long it has sold on Konga, units sold, delivered orders and delivery score, quality and communication ratings, plus one page of the seller's products (same row shape as search) and the seller's exact product count. | Retail analysts call seller to get a Konga marketplace seller's store. | seller_id |
| categories | Konga's category tree as the site's menu publishes it: category id, name, URL, parent id and depth (three levels). The ids work in search `category_id`. | Pricing teams call categories to get konga's category tree as the site's menu publishes it. | parent_id |
Call search from your stack
curl -X POST https://api.reefapi.com/konga/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone"}'import requests
r = requests.post(
"https://api.reefapi.com/konga/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "iphone"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/konga/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "iphone"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.konga.search with {"query":"iphone"}.Who uses this API and why
- Track Konga prices and discounts in naira daily for a product list.
- Compare Konga and Jumia prices for the same products in Nigeria.
- Monitor a marketplace seller's catalogue, stock and units sold.
- Find products fulfilled by Konga with express delivery in a category.
- Collect product ratings and reviews for Nigerian consumer research.
Questions developers ask before integrating
Which country and currency?
Nigeria. Konga sells in Nigeria only and every price is in naira (NGN), as whole numbers.
Do I need a Konga account?
No. Everything is read logged out: prices, stock, sellers, ratings and reviews.
Which filters are there and do they work?
Category, brand, seller, selling-price range, minimum rating, free shipping, pay on delivery, pickup, express delivery and fulfilled by Konga or the vendor. Each was checked against the unfiltered count in the same run: laptop 7,355 → express delivery 86, fulfilled by Konga 81; iphone 4,835 → 1.6-1.7 million naira 29, at most 5,000 naira 712; rice 1,343 → rated 4 or more 58; hp 8,631 → Laptops category 2,854.
Is the delivery fee included?
No. Konga does not publish a per-product delivery fee; it is calculated at checkout from the delivery address. The API returns the delivery options instead: free shipping, pay on delivery, pickup and express delivery.
How do I get all products of a seller?
Call seller with the seller id from any row's seller.id: you get the seller's store page and its products, 40 per page by default. search with seller_id gives the same products with every other filter available.
Can I sort by price?
Yes, sort=price_asc or price_desc orders by the price the buyer pays. relevance is the site's default order. There is no newest or rating sort on Konga.
How do I find category ids?
categories returns the site's category tree (586 categories in three levels) with ids, names and URLs. Every product also lists its categories, and the number at the end of a konga.com/category/... URL works too.
What is the Konga API?
Konga API is a ReefAPI endpoint group for nigeria's second-largest marketplace: naira prices, previous price and discount, stock and units sold, marketplace sellers, delivery options and reviews. It returns live JSON through POST requests under /konga/v1.
Is the Konga API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Konga calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Konga login or account?
No login to Konga is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Konga data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Konga API use?
Konga actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Konga from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call konga actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Konga API a Konga scraper?
It is the managed alternative to a DIY Konga scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same nigeria's second-largest marketplace: naira prices, previous price and discount, stock and units sold, marketplace sellers, delivery options and reviews back as clean JSON.