Konga API

Search Nigeria's second-largest marketplace, then read any product's naira price, stock, seller and reviews

Konga is Nigeria's second-largest online marketplace, with about 458,000 products listed by Konga itself and by marketplace sellers.

no credit card1,000 free credits · instant API key · pay by card or crypto
Missing a Konga endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
K
/konga/v1

5 active endpoints, on 1 and 2 credit tiers.

  • POST/konga/v1/search
  • POST/konga/v1/product
  • POST/konga/v1/reviews
  • POST/konga/v1/seller
  • POST/konga/v1/categories

What Konga endpoints does ReefAPI ship?

5 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

5 endpoints

search

2 cr

Search Konga (konga.com, Nigeria) by keyword and/or category, brand or seller, with price ran…

required
—
optional
query, category_id, brand, seller_id, min_price, max_price, min_rating, free_shipping, pay_on_delivery, pickup, express_delivery, fulfilled_by, sort, page, page_size

product

1 cr

Full record of one Konga product.

required
product_id
optional
—

reviews

1 cr

Customer reviews of one Konga product.

required
product_id
optional
—

seller

2 cr

A Konga marketplace seller's store.

required
seller_id
optional
—

categories

2 cr

Konga's category tree as the site's menu publishes it.

required
—
optional
parent_id

Every parameter, every allowed value →

Konga API

6 of 5 endpoints, ready to run

View docs ↗

iPhones on Konga

2 credits0 required · 1 optional
POST/konga/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

How the Konga API works

Konga is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 530 engines.

02
Call
POST /konga/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
1 or 2 credits per call

Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

From a keyword to a Konga price and seller feed

Search to find the products and their sellers, narrow with filters, then follow each product and seller.

01search?query=generator
GET/konga/v1/search?query=generator

40 products per page with naira price, previous price, stock, units sold, seller and the delivery options, plus the site's exact total.

02search?category_id=5230&fulfilled_by=konga&sort=price_asc&page_size=100
GET/konga/v1/search?category_id=5230&fulfilled_by=konga&sort=price_asc&page_size=100

One category, only products Konga ships itself, cheapest first, 100 per page; page on while has_more is true.

03product?product_id=<product_id>
GET/konga/v1/product?product_id=<product_id>

Description, specifications, variants with their own price and stock, categories and the seller's rating and delivery score.

04reviews?product_id=<product_id>
GET/konga/v1/reviews?product_id=<product_id>

The star histogram and every review with its comment, reviewer name and date.

05seller?seller_id=<seller.id>
GET/konga/v1/seller?seller_id=<seller.id>

The seller's store page and its products.

A dated naira price and stock feed per product, with the current and previous price kept apart, the seller behind each listing and the ratings next to it.

request
curl -X POST https://api.reefapi.com/konga/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"iphone"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "konga",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}

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.

FieldWhat it holds
price, price_before_discount, discount_percentprice 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_priceA time-limited deal price when Konga runs one for the product; it is already used as price when present.
stock_quantity, quantity_soldThe 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.
sellerThe 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_bykonga when Konga stocks and ships the product from its warehouse, vendor when the seller ships it.
free_shipping, pay_on_delivery, pickup_available, express_deliveryThe 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_countThe 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.
totalThe 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.

Konga coverage, measured

Every number below was read from live responses on 2026-10-15, in two runs.

Catalogue

458,176 products across the site. iphone 4,835; laptop 7,355; galaxy 8,051; rice 1,343; smart tv 1,783; generator 783; diapers 337; sneakers 513. 586 categories in the menu tree.

Filters that bite

laptop 7,355 → express delivery 86, fulfilled by Konga 81, pay on delivery 6,921; iphone 4,835 → 1.6-1.7 million naira 29, at most 5,000 naira 712; rice 1,343 → 4 stars or more 58; galaxy 8,051 → Samsung 2,689; hp 8,631 → Laptops 2,854. An unknown brand or category returns 0.

Price accuracy

Price equalled the product page's own figure on 16 of 16 products in 8 searches, crossed-out price on 8 of 8; search price equalled product price on 16 of 16.

Fields

On 440 search rows from 11 searches: product id, title, URL, image, price, stock, units sold, seller and delivery flags 440 of 440; category path 436; brand 308 (unbranded goods carry none); previous price 217 (the reduced products); rating 40 (most products have no rating yet). On 16 products: description, images, categories and seller 16 of 16, specifications 12, variants 4 (the configurable ones).

Limits

Delivery fees are not published per product. On some keywords the site mixes promoted products into filtered results; they are removed, so a filtered page can be shorter than page_size. Relevance and price are the only sort orders. Up to 100 products per page.

What people build with Konga

The jobs this data is most often used for.

5

endpoints

1/2

credits per call

01

Track Konga prices and discounts in naira daily for a product list.

02

Compare Konga and Jumia prices for the same products in Nigeria.

03

Monitor a marketplace seller's catalogue, stock and units sold.

04

Find products fulfilled by Konga with express delivery in a category.

What Konga data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 530 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/konga/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"iphone"}'
python
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"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Konga.

Get a free key →
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.

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 529 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-15.