Media, Film & Knowledge

DonanımHaber API

The DonanımHaber API returns forum topics, posts and sections from Turkey's largest technology forum as clean JSON, with the Turkish text intact and no login.

4 actionsLive JSON1,000 free creditsMCP-ready

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

The primary search endpoint runs a keyword query across every post and returns message_id, topic_id, title, excerpt, matched_words, the section it lives in, posted_at and the thread URL, alongside total_matches and pagination. From there, topic expands a thread into its opening post, author, dates, view and reply counts and its replies; section pages a single board; and sections lists the board directory so you can pick what to ingest. Reach for it when you need Turkish consumer-technology discussion — buying advice, fault and RMA threads, price talk, second-hand posts — as structured data instead of scraping a forum that has been running since 2001. One ReefAPI key, one shared credit pool, the standard { ok, data, meta, error } envelope.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Aug 22, 2026, 6:29 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/donanimhaber/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "ekran kartı",
    "search_in": "title",
    "limit": 10
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "donanimhaber",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 2679.3,
    "record_count": 10,
    "bytes": 7568,
    "cache_hit": false,
    "method": "own_search_api_and_ldjson_bare_dc",
    "upstream_pages": 1,
    "stop_reason": "limit_reached"
  },
  "data": {
    "results": [
      {
        "message_id": 163939433,
        "topic_id": 163939433,
        "is_opening_post": true,
        "title": "Satılık Arc B580 ekran kartı",
        "excerpt": "Arc B580 ekran kartını satıyorumSistem Notu : Bu ilan her türlü yoruma açıktır....",
        "matched_words": [
          "ekran",
          "kartı"
        ],
        "section_id": 265,
        "section": "Ekran Kartı",
        "posted_at": "[redacted-phone]T15:16:[redacted-phone]+03:00",
        "posted_label": "6 saat önce",
        "image": null,
        "url": "https://forum.donanimhaber.com/--[redacted-phone]",
        "topic_url": "https://forum.donanimhaber.com/--[redacted-phone]"
      },
      {
        "message_id": 163931473,
        "topic_id": 163931473,
        "is_opening_post": true,
        "title": "Ekran kartı ısınması",
        "excerpt": "...e götürmüştüm ilk önce anakart sonra işlemci en son da power supply değiştirdim ama her şeyi değiştirdikten sonra en basit oyunlar da bile GPU Sıcaklığı 90 üstü Gpu hotspot sıcaklığı ise 100 dereceyi buluyor ve birden inanılmaz bir şekilde ekran kartı aşırı sıcak oluyor bunun sebebi ne olabilir sizce daha önce böyle bir problem yoktu Ekran kartı - AMD Radeon RX 6700 XT\nCPU - AMD Ryzen 5 7500x3d\nAnakart - Asus Prime a620m-k\nRam - T-FORCE 8X2\nSupply - Gamepower 650...",
        "matched_words": [
          "Ekran",
          "kartı"
        ],
        "section_id": 183,
        "section": "Teknik Yardım",
        "posted_at": "[redacted-phone]T17:26:[redacted-phone]+03:00",
        "posted_label": "2 gün önce",
        "image": null,
        "url": "https://forum.donanimhaber.com/--[redacted-phone]",
        "topic_url": "https://forum.donanimhaber.com/--[redacted-phone]"
      },
      {
        "message_id": 163929780,
        "topic_id": 163929780,
        "is_opening_post": true,
        "title": "iki ekran kartı laptop oyun oynayamıyorum",
        "excerpt": "ikinci el laptop aldım bilgisayarda iki ekran kartı var driverlar yüklü görünüyor ama oyun açılmıyor \nekran kartı amd mobility radeon hd 5000 intel hd graphics ne yapmam gerekir...",
        "matched_words": [
          "ekran",
          "kartı"
        ],
        "section_id": 183,
        "section": "Teknik Yardım",
        "posted_at": "[redacted-phone]T11:58:[redacted-phone]+03:00",
        "posted_label": "2 gün önce",
        "image": null,
        "url": "https://forum.donanimhaber.com/--[redacted-phone]",
        "topic_url": "https://forum.donanimhaber.com/--[redacted-phone]"
      }
    ],
    "total_matches": 93154,
    "returned": 10,
    "page": 1,
    "pages_available": 1000,
    "did_you_mean": null,
    "query": "ekran kartı",
    "source": "donanimhaber"
  }
}

Actions

What the DonanımHaber API does

Action	Description	Concrete use case	Key params
search	Keyword-search every post on DonanımHaber Forum — the site's own search index, not a page scrape. Returns the matching post's title, excerpt, section, author-visible timestamp and a deep link to the exact message. Filter to opening posts only (topic search), to one section, or to one thread; sort by recency or relevance. Ideal for Turkish-market demand signals, product mentions and support chatter.	Content platforms call search to get keyword-search every post on DonanımHaber Forum.	query, search_in, match, sort, first_post_only, ...
topic	Full detail for one DonanımHaber Forum thread: title, the complete opening post as clean text, the author (public handle, profile, staff title, lifetime post count), published/last-updated timestamps, the section it lives in, view / post / like counts, and the replies on the requested page with their own authors, timestamps and like counts.	Research tools call topic to get full detail for one DonanımHaber Forum thread.	topic, page
section	List the topics in one DonanımHaber Forum section, newest activity first, with pagination (65 topics per page). Each row carries the title, the site's own opening-post teaser, the thread starter, reply and view counts, and the last-post timestamp — enough to monitor a section without opening a single thread.	Community analysts call section to list the topics in one DonanımHaber Forum section, newest activity first, with pagination (65….	section, page, limit, query, posted_within, ...
sections	The DonanımHaber Forum section directory — every public section with its numeric id, name and URL, optionally filtered by name. Use it to resolve a topic area ('SEO', 'yazılım', 'ekran kartı') to the `section` id that `search` and `section` take.	Media monitors call sections to get the DonanımHaber Forum section directory.	query, limit

Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/donanimhaber/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"ekran kartı","search_in":"title","limit":10}'

import requests

r = requests.post(
    "https://api.reefapi.com/donanimhaber/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "ekran kartı",
  "search_in": "title",
  "limit": 10
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/donanimhaber/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "query": "ekran kartı",
  "search_in": "title",
  "limit": 10
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.donanimhaber.search with {"query":"ekran kartı","search_in":"title","limit":10}.

Use cases

Who uses this API and why

Brand and support teams call search to find every Turkish forum thread mentioning a model number or a recurring fault.
Market researchers page a board with section to see what buyers in a category (graphics cards, motherboards) are actually asking.
Dataset and community tools use topic to pull a thread's opening post plus its full reply chain in one call.
Ingestion pipelines use sections first to map the board directory before deciding which sections to poll.

FAQ

Questions developers ask before integrating

What is the DonanımHaber API?

DonanımHaber API is a ReefAPI endpoint group for forum topics, posts and sections from turkey's biggest technology forum. It returns live JSON through POST requests under /donanimhaber/v1.

Is the DonanımHaber API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. DonanımHaber calls use the same shared credit balance as every other ReefAPI engine.

Do I need a DonanımHaber login or account?

No login to DonanımHaber 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 DonanımHaber 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 DonanımHaber API use?

DonanımHaber actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call DonanımHaber from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call donanimhaber actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the DonanımHaber API a DonanımHaber scraper?

It is the managed alternative to a DIY DonanımHaber 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 forum topics, posts and sections from turkey's biggest technology forum back as clean JSON.

Why does my DonanımHaber scraper keep getting blocked?

Most DonanımHaber 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 or failed calls are free.

docs / donanimhaber

DonanımHaber

Forum topics, posts and sections from Turkey's biggest technology forum.

base /donanimhaber/v14 endpoints

post/donanimhaber/v1/search1 credit

Keyword-search every post on DonanımHaber Forum — the site's own search index, not a page scrape. Returns the matching post's title, excerpt, section, author-visible timestamp and a deep link to the exact message. Filter to opening posts only (topic search), to one section, or to one thread; sort by recency or relevance. Ideal for Turkish-market demand signals, product mentions and support chatter.

Parameter		Allowed / range	Description
query	required	—	Turkish (or English) keyword(s) to find in DonanımHaber Forum posts — e.g. 'veri çekme', 'ekran kartı', 'RTX 5090'. Turkish characters (ı ş ğ ç ö ü) are sent through unchanged.
search_in = all	optional	all · title · body	Where to look. 'all' searches title AND body and is very broad (the site stems Turkish words, so 'veri' also matches 'verimli'). Use 'title' when you want precision — measured 204 title hits vs 19 541 all-field hits for the same query.
match = both	optional	both · any · exact	How the words are combined: 'both' = every word (any order), 'any' = at least one word, 'exact' = the phrase as typed.
sort = date	optional	date · date_asc · rank	Result order. 'date' (newest first) is the freshness feed; 'rank' is best-match first.
first_post_only = false	optional	—	Match only the OPENING post of each thread instead of every reply. Turns a noisy message search into a topic search — good for lead/demand hunting ('who is ASKING for this?').
section	optional	—	A forum section: the numeric id (2770), 'f2770', the section URL, or the '<slug>--f2770' slug. Use the `sections` action to find ids by name, or read `section_id` off any `search` hit.
topic	optional	—	The topic: numeric topic id (163852334), the full topic URL, or the '<slug>--<id>' slug. All three resolve to the same thread.
posted_within	optional	1d · 3d · 7d · 30d · 90d · 365d	Keep only posts newer than this. NOTE: the upstream search's own date-range field is a no-op (measured: identical totals for every value), so this filter is applied by us over a newest-first result stream — `total_matches` still reports the unfiltered upstream total, and `returned` reports what survived.
limit = 20	optional	1–100	How many posts to return (1–100, default 20).
page = 1	optional	1–1000	1-based page number (1–1000).
search_offline = false	optional	—	Skip the site's search host (which is crawler-disallowed by its own robots.txt) and keyword-filter a robots-ALLOWED section listing instead. Requires `section`. Narrower coverage, fully robots-clean.

Try in playground →

post/donanimhaber/v1/topic1 credit

Full detail for one DonanımHaber Forum thread: title, the complete opening post as clean text, the author (public handle, profile, staff title, lifetime post count), published/last-updated timestamps, the section it lives in, view / post / like counts, and the replies on the requested page with their own authors, timestamps and like counts.

Parameter		Allowed / range	Description
topic	required	—	The topic: numeric topic id (163852334), the full topic URL, or the '<slug>--<id>' slug. All three resolve to the same thread.
page = 1	optional	1–5000	1-based page number (1–5000).

Try in playground →

post/donanimhaber/v1/section1 credit

List the topics in one DonanımHaber Forum section, newest activity first, with pagination (65 topics per page). Each row carries the title, the site's own opening-post teaser, the thread starter, reply and view counts, and the last-post timestamp — enough to monitor a section without opening a single thread.

Parameter		Allowed / range	Description
section	required	—	A forum section: the numeric id (2770), 'f2770', the section URL, or the '<slug>--f2770' slug. Use the `sections` action to find ids by name, or read `section_id` off any `search` hit.
page = 1	optional	1–5000	1-based page number (1–5000).
limit = 65	optional	1–65	How many topics to return (1–65, default 65).
query	optional	—	Optional client-side keyword filter over the titles/teasers on this page.
posted_within	optional	1d · 3d · 7d · 30d · 90d · 365d	Keep only posts newer than this. NOTE: the upstream search's own date-range field is a no-op (measured: identical totals for every value), so this filter is applied by us over a newest-first result stream — `total_matches` still reports the unfiltered upstream total, and `returned` reports what survived.
include_sticky = true	optional	—	Include the section's pinned/announcement topics (they are not sorted by recency).

Try in playground →

post/donanimhaber/v1/sections1 credit

The DonanımHaber Forum section directory — every public section with its numeric id, name and URL, optionally filtered by name. Use it to resolve a topic area ('SEO', 'yazılım', 'ekran kartı') to the `section` id that `search` and `section` take.

Parameter		Allowed / range	Description
query	optional	—	Filter sections whose name or slug contains this text (accent/case-insensitive). Omit for the full directory.
limit = 120	optional	1–800	How many sections to return (1–800, default 120).

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/donanimhaber/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"ekran kartı","search_in":"title","limit":10}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}