Kufar.by API & Scraper
Kufar.by API returns live Kufar.by data as clean JSON for kufar.by The primary endpoint, search, returns total_results (every match Kufar counts), reachable_results (how many of them Kufar will serve for this search: at most 1,000), page, pag….
🤖 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.
Developers reach for it when they need to read second-hand listings, asking prices, seller inventory and country-specific listing ids without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Kufar.by scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, listing, categories, regions. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/kufar/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "холодильник"
}
}{
"ok": true,
"meta": {
"api": "kufar",
"endpoint": "search",
"mode": "live",
"latency_ms": 1212.9,
"record_count": 30,
"bytes": 87112,
"cache_hit": false,
"source_url": "https://api.kufar.by/search-api/v2/search/rendered-paginated?lang=ru&query=%D1%85%D0%BE%D0%BB%D0%BE%D0%B4%D0%B8%D0%BB%D1%8C%D0%BD%D0%B8%D0%BA&sort=lst.d&size=30",
"charged_credits": 1,
"version": "1.0.1",
"request_id": "62b744888dd94337",
"queue_ms": 1.9,
"fetched_at": "2026-11-03T17:32:07.958Z"
},
"data": {
"total_results": 32104,
"page": 1,
"page_size": 30,
"returned": 30,
"has_more": true,
"page_type": "search_page",
"listings": [
{
"listing_id": "1076168825",
"url": "https://www.kufar.by/item/1076168825",
"title": "Холодильники На Гарантии Доставка по всей РБ",
"description_excerpt": null,
"price": 520,
"price_currency": "BYN",
"price_currency_raw": "BYR",
"price_kind": "fixed",
"price_byn": 520,
"price_conversions": {
"USD": 175.98,
"EUR": 156.87,
"BYN": 520,
"RUB": 14216.58
},
"category_id": "15020",
"category_name": "Крупная техника для кухни",
"region_id": 7,
"region_name": "Минск",
"area_id": 28,
"area_name": "Октябрьский",
"listing_type": "sell",
"posted_at": "2026-11-03T17:31:59Z",
"seller_type": "company",
"seller_name": "ИП Рогозин Алексей Григорьевич",
"seller_account_id": "OweHRzde0D67dtADzY60Igg",
"phone_hidden": false,
"promoted": false,
"highlighted": false,
"image": "https://rms.kufar.by/v1/gallery/adim1/03a473b6-276d-43c6-9783-3927403d0ff1.jpg",
"images": [
"https://rms.kufar.by/v1/gallery/adim1/03a473b6-276d-43c6-9783-3927403d0ff1.jpg",
"https://rms.kufar.by/v1/gallery/adim1/bbe589a5-e13d-4720-922e-2c5f91692a9f.jpg"
],
"image_thumbnails": [
"https://rms.kufar.by/v1/prc_thumbs/adim1/03a473b6-276d-43c6-9783-3927403d0ff1.jpg",
"https://rms.kufar.by/v1/prc_thumbs/adim1/bbe589a5-e13d-4720-922e-2c5f91692a9f.jpg"
],
"image_count": 2,
"attributes": [
{
"name": "[trimmed-depth]",
"label": "[trimmed-depth]",
"value": "[trimmed-depth]",
"raw_value": "[trimmed-depth]",
"query_key": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"label": "[trimmed-depth]",
"value": "[trimmed-depth]",
"raw_value": "[trimmed-depth]",
"query_key": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"label": "[trimmed-depth]",
"value": "[trimmed-depth]",
"raw_value": "[trimmed-depth]",
"query_key": "[trimmed-depth]"
}
]
},
{
"listing_id": "1093009019",
"url": "https://www.kufar.by/item/1093009019",
"title": "Холодильник",
"description_excerpt": null,
"price": 25,
"price_currency": "BYN",
"price_currency_raw": "BYR",
"price_kind": "fixed",
"price_byn": 25,
"price_conversions": {
"USD": 8.46,
"EUR": 7.54,
"BYN": 25,
"RUB": 683.49
},
"category_id": "15020",
"category_name": "Крупная техника для кухни",
"region_id": 5,
"region_name": "Минская область",
"area_id": 105,
"area_name": "Узда",
"listing_type": "sell",
"posted_at": "2026-11-03T17:29:20Z",
"seller_type": "private",
"seller_name": "Ирина",
"seller_account_id": "O-8D9yxDcdn-N_CnG2viYbY",
"phone_hidden": true,
"promoted": false,
"highlighted": false,
"image": "https://rms.kufar.by/v1/gallery/adim1/d3cd4aae-f755-42f3-864c-639897252259.jpg",
"images": [
"https://rms.kufar.by/v1/gallery/adim1/d3cd4aae-f755-42f3-864c-639897252259.jpg"
],
"image_thumbnails": [
"https://rms.kufar.by/v1/prc_thumbs/adim1/d3cd4aae-f755-42f3-864c-639897252259.jpg"
],
"image_count": 1,
"attributes": [
{
"name": "[trimmed-depth]",
"label": "[trimmed-depth]",
"value": "[trimmed-depth]",
"raw_value": "[trimmed-depth]",
"query_key": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"label": "[trimmed-depth]",
"value": "[trimmed-depth]",
"raw_value": "[trimmed-depth]",
"query_key": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"label": "[trimmed-depth]",
"value": "[trimmed-depth]",
"raw_value": "[trimmed-depth]",
"query_key": "[trimmed-depth]"
}
]
},
{
"listing_id": "1056699571",
"url": "https://www.kufar.by/item/1056699571",
"title": "Ремонт холодильников и морозильников",
"description_excerpt": null,
"price": null,
"price_currency": "BYN",
"price_currency_raw": "BYR",
"price_kind": "negotiable",
"price_byn": null,
"price_conversions": {
"USD": null,
"EUR": null,
"BYN": null,
"RUB": null
},
"category_id": "13210",
"category_name": "Ремонт техники и электроники",
"region_id": 7,
"region_name": "Минск",
"area_id": 25,
"area_name": "Партизанский",
"listing_type": "sell",
"posted_at": "2026-11-03T17:27:59Z",
"seller_type": "company",
"seller_name": "ИП Кочервин Александр Евгеньевич",
"seller_account_id": "O60aen7AdEpST_u6Ux3FOh8",
"phone_hidden": false,
"promoted": false,
"highlighted": false,
"image": "https://rms.kufar.by/v1/gallery/adim1/510326b5-fc02-4011-a928-6090eedcbc34.jpg",
"images": [
"https://rms.kufar.by/v1/gallery/adim1/510326b5-fc02-4011-a928-6090eedcbc34.jpg"
],
"image_thumbnails": [
"https://rms.kufar.by/v1/prc_thumbs/adim1/510326b5-fc02-4011-a928-6090eedcbc34.jpg"
],
"image_count": 1,
"attributes": [
{
"name": "[trimmed-depth]",
"label": "[trimmed-depth]",
"value": "[trimmed-depth]",
"raw_value": "[trimmed-depth]",
"query_key": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"label": "[trimmed-depth]",
"value": "[trimmed-depth]",
"raw_value": "[trimmed-depth]",
"query_key": "[trimmed-depth]"
},
{
"name": "[trimmed-depth]",
"label": "[trimmed-depth]",
"value": "[trimmed-depth]",
"raw_value": "[trimmed-depth]",
"query_key": "[trimmed-depth]"
}
]
}
],
"query": "холодильник",
"filters": {
"lang": "ru",
"sort": "lst.d"
}
}
}What the Kufar.by API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Kufar classifieds by keyword and/or category, region, city/district, price band, ad type and seller type, with four sorts and paging (up to 200 ads per page). Kufar serves at most 1,000 ads per search (e.g. 5 pages of 200) even when `total_results` is larger: `reachable_results` says how many one search can reach, and to collect more split the search by `region` (1-7) and, for Minsk (region 7), by `area` (the `regions` action lists the ids) — measured 2026-11-15, the 7 regions summed to exactly the unsplit total. | Price-intelligence teams call search to search Kufar classifieds by keyword and/or category, region, city/district, price band, ad ty…. | query, category, region, area, price_min, ... |
| listing | Full detail of one Kufar ad by id or URL: the complete description, price in the seller's own currency with Kufar's conversions, location, posting time, seller display name and account id, every photo, and all category attributes. Text is returned as the seller wrote it (a phone typed into the description stays). The phone behind Kufar's reveal button is not requested — only Kufar's own `phone_hidden` flag. | Classifieds aggregators call listing to get full detail of one Kufar ad by id or URL. | listing_id, url |
| categories | Kufar's live category tree — the resolver `search` needs, because the `category` filter takes numeric ids. 22 top-level groups and 214 subcategories, each with its Russian and Belarusian name. | Resale and arbitrage tools call categories to get kufar's live category tree. | category, language |
| regions | Kufar's live region and city/district table — the resolver the `region` and `area` search filters need. Seven regions, each with every city/district id Kufar offers. | Lead-generation teams call regions to get kufar's live region and city/district table. | none |
Call search from your stack
curl -X POST https://api.reefapi.com/kufar/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"холодильник"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/kufar/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "холодильник"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/kufar/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "холодильник"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.kufar.search with {"query":"холодильник"}.Who uses this API and why
- Price-intelligence teams use Kufar.by to search Kufar classifieds by keyword and/or category, region, city/district, price band, ad ty….
- Classifieds aggregators use Kufar.by to get full detail of one Kufar ad by id or URL.
- Resale and arbitrage tools use Kufar.by to get kufar's live category tree.
- Lead-generation teams use Kufar.by to get kufar's live region and city/district table.
Questions developers ask before integrating
What is the Kufar.by API?
Kufar.by API is a ReefAPI endpoint group for kufar.by It returns live JSON through POST requests under /kufar/v1.
Is the Kufar.by API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Kufar.by calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Kufar.by login or account?
No login to Kufar.by 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 Kufar.by 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 Kufar.by API use?
Kufar.by actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Kufar.by from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call kufar actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Kufar.by API a Kufar.by scraper?
It is the managed alternative to a DIY Kufar.by 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 kufar.by back as clean JSON.
Why does my Kufar.by scraper keep getting blocked?
Most Kufar.by scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.