Media, Film & Knowledge

News Articles API

The News Article API extracts a clean article from any news URL as clean JSON.

2 actionsLive JSON1,000 free creditsMCP-ready

🤖 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 extract endpoint returns the article's title, text, author, date, top image, images, language, site name and canonical URL, and you can also run a news_search. It is built for RAG pipelines, media monitoring and reader apps that need clean article content without a headless browser. One ReefAPI key, one shared credit pool, the standard envelope.

Live example

Real request and response JSON

Captured from the indexed primary action, extract, on Jul 18, 2026, 5:19 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/news-article/v1/extract",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "url": "https://en.wikipedia.org/wiki/Web_scraping"
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "news-article",
    "endpoint": "extract",
    "mode": "live",
    "latency_ms": 1161.2,
    "record_count": 1,
    "bytes": 231114,
    "cache_hit": false,
    "completeness_pct": 85.71,
    "stop_reason": "bare",
    "requests": 1,
    "rendered": false,
    "resolved_from": null
  },
  "data": {
    "article": {
      "url": "https://en.wikipedia.org/wiki/Web_scraping",
      "canonical": "https://en.wikipedia.org/wiki/Web_scraping",
      "title": "Web scraping - Wikipedia",
      "author": "Contributors to Wikimedia projects",
      "date": "[redacted-phone]",
      "text": "Web scraping, web harvesting, or web data extraction is data scraping used for extracting data from websites. Web scraping software may directly access the World Wide Web using the Hypertext Transfer Protocol or a web browser. While web scraping can be done manually by a software user, the term typically refers to automated processes implemented using a bot or web crawler. It is a form of copying in which specific data is gathered and copied from the web, typically into a central local database or spreadsheet, for later retrieval or analysis.\nScraping a web page involves fetching it and then e",
      "excerpt": "Web scraping, web harvesting, or web data extraction is data scraping used for extracting data from websites. Web scraping software may directly access the World Wide Web using the Hypertext Transfer Protocol or a web browser. While web scraping can be done manually by a software…",
      "top_image": null,
      "images": [
        "https://upload.wikimedia.org/wikipedia/en/thumb/9/99/Question_book-new.svg/60px-Question_book-new.svg.png",
        "https://upload.wikimedia.org/wikipedia/en/thumb/b/b4/Ambox_important.svg/40px-Ambox_important.svg.png",
        "https://upload.wikimedia.org/wikipedia/commons/thumb/b/bd/Ambox_globe_content.svg/60px-Ambox_globe_content.svg.png"
      ],
      "language": "en",
      "site_name": "Wikimedia Foundation, Inc.",
      "favicon": "https://en.wikipedia.org/static/apple-touch/wikipedia.png",
      "section": null,
      "keywords": [],
      "word_count": 4094,
      "reading_time_min": 19,
      "content_markdown": "| ![icon](https://upload.wikimedia.org/wikipedia/en/thumb/9/99/Question_book-new.svg/60px-Question_book-new.svg.png) | \n\n**Web scraping**, **web harvesting**, or **web data extraction** is [data scraping](https://en.wikipedia.org/wiki/Data_scraping) used for [extracting data](https://en.wikipedia.org/wiki/Data_extraction) from [websites](https://en.wikipedia.org/wiki/Website).\n\n[World Wide Web](https://en.wikipedia.org/wiki/World_Wide_Web)using the\n\n[Hypertext Transfer Protocol](https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol)or a web browser. While web scraping can be done manually "
    }
  }
}

Actions

What the News Articles API does

Action	Description	Concrete use case	Key params
extract	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.	Content platforms call extract to extract a clean article from any news or blog URL.	url, render, include_markdown
news_search	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	Research tools call news_search to get recent-news list from source=google\|bing\|gdelt\|rss\|all (unified schema title/url/source/publi….	query, source, lang, country, limit, ...

Code samples

Call extract from your stack

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"}'

import requests

r = requests.post(
    "https://api.reefapi.com/news-article/v1/extract",
    headers={"x-api-key": REEF_KEY},
    json={
  "url": "https://en.wikipedia.org/wiki/Web_scraping"
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/news-article/v1/extract", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "url": "https://en.wikipedia.org/wiki/Web_scraping"
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.news-article.extract with {"url":"https://en.wikipedia.org/wiki/Web_scraping"}.

Use cases

Who uses this API and why

RAG pipelines call extract to turn a news URL into clean text for an LLM.
Media-monitoring tools use news_search then extract to track coverage of a topic.
Reader apps use extract to strip a page down to its article body.

FAQ

Questions developers ask before integrating

What is the News Articles API?

News Articles API is a ReefAPI endpoint group for extract clean article text from any news url. It returns live JSON through POST requests under /news-article/v1.

Is the News Articles API free to try?

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

Do I need a News Articles login or account?

No login to News Articles 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 News Articles data?

The page example is captured from a live extract call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the News Articles API use?

News Articles actions currently cost 1-2 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call News Articles from an AI assistant or MCP client?

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

Is the News Articles API a News Articles scraper?

It is the managed alternative to a DIY News Articles 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 extract clean article text from any news url back as clean JSON.

Why does my News Articles scraper keep getting blocked?

Most News Articles 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 / 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).

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

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
}