Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Kufar.by API page →
Classifieds & Second-hand

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….

4 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 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.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/kufar/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "холодильник"
  }
}
Captured response
{
  "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"
    }
  }
}
Actions

What the Kufar.by API does

ActionDescriptionConcrete use caseKey params
searchSearch 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, ...
listingFull 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
categoriesKufar'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
regionsKufar'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
Code samples

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":"холодильник"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.kufar.search with {"query":"холодильник"}.
Use cases

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.
FAQ

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.

docs / kufar

Kufar.by

Kufar.by

base /kufar/v14 endpoints
post/kufar/v1/listing1 credit

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.

ParameterAllowed / rangeDescription
listing_idoptional—Kufar ad id — the number in the ad URL and in every search row's `listing_id`. Give this or `url`.
urloptional—Full ad URL, exactly as a search row returns it (real-estate and car ads live on re./auto. subdomains — both are accepted).
Try in playground →
post/kufar/v1/categories1 credit

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.

ParameterAllowed / rangeDescription
categoryoptional—Omit to get all 22 top-level groups with their subcategories; pass a group id to get just that group.
language = ruoptionalru · byLanguage of Kufar's own labels (category/region names). Ad titles and bodies are returned exactly as the seller typed them.
Try in playground →
post/kufar/v1/regions1 credit

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.

Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.