docs / news-article

News Articles

Extract clean article text from any news URL.

base /news-article/v12 endpoints

post/news-article/v1/extract2 credits

Extract a clean article from any news or blog URL: returns title, full text, author, publication date, top image, all images, language, site name, and canonical URL. Automatically follows Google News and Bing News redirect links to the original publisher page.

Parameter		Allowed / range	Description
url	required	—	Article URL to extract. Google-News / Bing-News redirect URLs are auto-resolved to the real publisher URL first.
render = auto	optional	auto · never · force	Browser-render policy. NOTE: this image ships without a browser, so render is a graceful no-op (meta.rendered=false); recon proved it recovers ~0.
include_markdown = true	optional	—	Also return the article body as Markdown (default true).
timeout = 20	optional	1–	Per-request timeout in seconds (default 20).
max_attempts = 3	optional	1–	Max fetch attempts before giving up (default 3).

Try in playground →

post/news-article/v1/news_search1 credit

recent-news list from source=google|bing|gdelt|rss|all (unified schema title/url/source/published/lang); resolve=true → Google-News URLs become real publisher URLs

Parameter		Allowed / range	Description
query	optional	—	Search keywords. Required for source=google\|bing\|gdelt\|all (not for source=rss).
source = google	optional	google · bing · gdelt · rss · all	News backend. Unknown values are rejected. source=rss requires rss_url.
lang = en	optional	—	UI/content language hint (e.g. en, tr, de). Default en.
country = US	optional	—	Edition country, ISO 3166 alpha-2 (e.g. US, GB, TR). Default US.
limit = 20	optional	1–100	Max results (1-100, default 20); clamped.
rss_url	optional	—	Custom RSS/Atom feed URL — required when source=rss.
resolve = false	optional	—	If true, resolve Google-News result URLs to the real publisher URL (extra requests).
timeout = 20	optional	1–	Per-request timeout in seconds (default 20).
max_attempts = 3	optional	1–	Max fetch attempts before giving up (default 3).

Try in playground →

Example request · extract

curl -X POST https://api.reefapi.com/news-article/v1/extract \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"url":"https://en.wikipedia.org/wiki/Web_scraping"}'

Response shape

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