Every Portuguese store's price for a product, with shipping and total, and 90 days of price history
KuantoKusta (kuantokusta.pt) is Portugal's largest price comparison site and also a marketplace: some offers are bought on the shop's own site, others through KuantoKusta's checkout.
6 active endpoints, on 1, 2 and 3 credit tiers.
- POST/kuantokusta/v1/search
- POST/kuantokusta/v1/category
- POST/kuantokusta/v1/categories
- POST/kuantokusta/v1/product
- POST/kuantokusta/v1/offers
- POST/kuantokusta/v1/price_history
What KuantoKusta endpoints does ReefAPI ship?
6 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
KuantoKusta API
5 of 6 endpoints, ready to run
Find products by keyword
// 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 KuantoKusta API works
KuantoKusta is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 530 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a keyword to the cheapest delivered price and its price curve
Search KuantoKusta, pick the products, then read their offers and price history.
Product rows with product_id, the lowest price, offer count, brand and marketplace availability; area, brand, price and feature facets with counts.
Every offer: store, price, shipping, total, delivery window, store or marketplace row, featured and buy-box flags.
91 daily points with the lowest and average offer price, plus the period's lowest point.
EAN and SKU codes, spec sheet, description, variations and refurbished alternatives.
A dated, delivered-price feed per product: the cheapest total today, every competing offer, and three months of daily lows and averages to judge it against.
curl -X POST https://api.reefapi.com/kuantokusta/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone 17"}'{
"ok": true,
"data": { … },
"meta": {
"api": "kuantokusta",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a KuantoKusta field actually contains
Fields that read differently from how they look. Every row was measured against the live site on 2026-10-15.
| Field | What it holds |
|---|---|
| price_min (search, category, product) | The lowest offer price for the product, in euros. It equalled the cheapest row of the offer list on 10 of 10 products, and the price on the product page on 10 of 10 search rows and 5 of 5 category rows. |
| offers[].offer_type | store: bought on the shop's own website. marketplace: bought through KuantoKusta's checkout ("Comprar no KuantoKusta"), with a delivery window and loyalty points. 8 of 10 sampled products had both kinds. |
| offers[].total_price | price + shipping_cost, the same Total the product page prints ("1.649,00 € Envio + 3,90 € Total 1.652,90 €"). Every Total printed on 6 product pages (up to 15 per page) was found among the API's totals: 0 mismatches. |
| offers[].shipping_cost, free_shipping | The shipping the store publishes (its minimum). free_shipping is true when that is 0 €, which is what the page prints as "Envio Grátis!". free_shipping_programme is the site's separate free-shipping badge: Fnac Portugal charged 0 € without it. |
| buy_box_offer, is_featured | The highlighted "Comprar no KuantoKusta" box and the featured rows the page shows first. Neither is the cheapest by rule: on an iPhone 18 Pro Max the buy box was 1,799 € while the cheapest store sold at 1,596 €. Use cheapest_offer and cheapest_total_offer. |
| total, total_capped, matching_total | The site's search total stops at 1,000 (21 pages of 48). "iphone 17" printed 1,000 while the site's own section counts add up to 42,203; total_capped marks it and matching_total carries the full count. Category totals are not capped (Smartphones 1,979). |
| price_history.points[] | One point per day: min_price (the day's lowest offer) and avg_price (the day's average offer). The site states that Amazon.es prices are not included. Each call is checked against the product page's own published average price; colour variants of one phone share 0 of 31 points, so the series is per product, not per product family. |
| variations, refurbished | Colour and storage siblings and the refurbished grade of the same model, each with its own product_id that works in product, offers and price_history (3 of 3 checked in each of two runs). |
Prices are in euros as the site prints them for Portugal.
KuantoKusta coverage, measured
Every number below was read from the live site on 2026-10-15, in two runs of 116 and 119 calls.
Portugal, euros. "tv 55" matched 734 products, "air fryer" 502; the Smartphones category held 1,979, Frigoríficos 1,996; broad searches stop at the site's 1,000 cap.
"tv 55" 734 → 300 to 600 € 163 (48 of 48 rows inside), Samsung 68, marketplace 441, good deal 159; Smartphones 1,979 → 300 to 600 € 539, up to 100 € 38, Xiaomi 461, black 513.
Search and category price_min equalled the product's price_min on 15 of 15 products; the cheapest offer row equalled it on 10 of 10; every printed Total on 6 product pages matched an API total.
31 daily points for 30 days and 91 for 90 days; 10 of 10 products verified against their own page.
Every product_id from search, category, variations and refurbished alternatives came back as the same product: 18 of 18 in each of two runs.
Search totals stop at 1,000 and 21 pages of 48; price history only for 30 or 90 days and without Amazon.es; no per-offer stock; no product reviews.
What people build with KuantoKusta
The jobs this data is most often used for.
endpoints
credits per call
Track every Portuguese store's price, shipping and total for a list of products by EAN.
Find the cheapest delivered price, not just the cheapest sticker price.
See which products can be bought through KuantoKusta's own checkout and at what price.
Judge today's price against 90 days of daily lows and averages.
What KuantoKusta 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 →- 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 -X POST https://api.reefapi.com/kuantokusta/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone 17"}'import requests
r = requests.post(
"https://api.reefapi.com/kuantokusta/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "iphone 17"
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up KuantoKusta.
Get a free key →Do I need a KuantoKusta account?▾
No. Everything is read logged out.
Does the total include shipping?▾
Yes. total_price is price plus shipping_cost, the same Total the product page prints for each offer. Every printed Total on 6 product pages matched an API total.
Which offers can be bought on KuantoKusta itself?▾
Rows with offer_type marketplace. Rows with offer_type store send the buyer to the shop's own site. Filter with offer_type=marketplace, or use marketplace_only on search and category.
Is the buy box the cheapest offer?▾
Not necessarily. On an iPhone 18 Pro Max the highlighted buy box was 1,799 € and the cheapest store 1,596 €. cheapest_offer and cheapest_total_offer are computed from all rows.
How far back does price_history go?▾
30 days (31 points) or 90 days (91 points), the two ranges the site offers. Each point is the day's lowest and average offer price. Amazon.es prices are not included, as the site itself states.
Is the price history really the product I asked for?▾
Every call compares the series with the average price printed on the product's own page and refuses a series that does not match. In the runs on 2026-10-15, 10 of 10 products were verified.
Why does search say total 1000?▾
The site stops counting search results at 1,000. total_capped is true then, and matching_total carries the site's full count ("capa iphone": 37,755). Category listings are not capped.
Which filters are there?▾
Price range, brand, marketplace-only and good-deal-only on search; the same plus brand_id and feature_id on category. Checked against the unfiltered count in the same run: "tv 55" 734 → 300 to 600 € 163, Samsung 68, marketplace 441; Smartphones 1,979 → 300 to 600 € 539, Xiaomi 461, black 513.
What is the KuantoKusta API?▾
KuantoKusta API is a ReefAPI endpoint group for portugal's price comparison site: every store's price, shipping and total for a product, kuantokusta marketplace offers, and 30 or 90 days of price history. It returns live JSON through POST requests under /kuantokusta/v1.
Is the KuantoKusta API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. KuantoKusta calls use the same shared credit balance as every other ReefAPI engine.
Do I need a KuantoKusta login or account?▾
No login to KuantoKusta 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 KuantoKusta 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 KuantoKusta API use?▾
KuantoKusta actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call KuantoKusta from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call kuantokusta actions with the same key, credit pool and JSON envelope used by normal REST requests.
266 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling KuantoKusta, you are one call away from the rest of the category — no second contract, no second integration.
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.
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.