CNN API

CNN headlines and full article text as JSON, with section, type and keyword filters.

The API.SH CNN API turns cnn.com into structured JSON. Get everything CNN published in the last two days with headline, link, times, section, type, keywords and image, filter by section, type, keyword or time, or go back through CNN's monthly section archive. Then pull any article by its link for the headline, byline and authors, published and updated times, word count, images with captions and the full body text.

Get a free API key Try it in the playground

2 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

CNN article by link

GET https://api.api.sh/cnn/v1/article

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the CNN API

News monitoring

Poll the latest headlines for a section or keyword and get alerted when CNN publishes on your topic.

/headlines

Full-text article datasets

Fetch article bodies with bylines, sections and dates for NLP, sentiment analysis or media research.

/article

Historical coverage research

Use the monthly archive to list a section's stories for any month and study how coverage changed over time.

/headlines /article

AI agents and RAG

Give an agent current CNN headlines and the full text of the stories it needs to answer questions about the news.

/headlines /article

Media and author analysis

Track which authors and sections publish what, and how often stories are updated after publication.

/article /headlines

CNN data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

CNN API endpoints and prices

Every CNN endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

More data2

CNN article by link /cnn/v1/article	$1 · $2 PAYG 1 credit
CNN headlines of the last two days /cnn/v1/headlines	$1 · $2 PAYG 1 credit

Call the CNN API

CNN article by link: GET https://api.api.sh/cnn/v1/article

curl "https://api.api.sh/cnn/v1/article?url=https%3A%2F%2Fwww.cnn.com%2F2020%2F11%2F07%2Fpolitics%2Fjoe-biden-wins-us-presidential-election%2Findex.html" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/cnn/v1/article",
    params={"url": "https://www.cnn.com/2020/11/07/politics/joe-biden-wins-us-presidential-election/index.html"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/cnn/v1/article");
url.searchParams.set("url", "https://www.cnn.com/2020/11/07/politics/joe-biden-wins-us-presidential-election/index.html");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/cnn/v1/article", "url", "https://www.cnn.com/2020/11/07/politics/joe-biden-wins-us-presidential-election/index.html")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "CNN" and "CNN article by link".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for CNN data

Public data only: no CNN login, cookies or account needed
One key and one response shape for CNN and 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official CNN API

CNN does not offer a public, self-serve developer API. The CNN APIs that rank are third-party listings on RapidAPI and scrapers on Apify. API.SH returns public CNN headlines and articles as JSON with one key.

Rather than running your own CNN scraper or trusting a RapidAPI listing, API.SH gives you headlines and full articles at a fixed price per call, in the same response shape as its other news sources.

CNN API questions

What CNN data can I get?+

Headlines from the last two days with section, type, keyword and time filters, plus monthly section archives (/cnn/v1/headlines), and one article by link with authors, dates, images and full body text (/cnn/v1/article).

How much does the CNN API cost?+

Every CNN endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free CNN API?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /cnn/v1/article at 1 credit each.

Is there an official CNN API?+

No. CNN has no public developer API or API key program. Third-party options include RapidAPI listings, Apify scrapers and API.SH.

Do I need a CNN account or login?+

No. API.SH reads public cnn.com pages only. No endpoint uses a login, cookies or a subscription.

Can I search old CNN headlines?+

Yes. Pass month (and optionally section) to /cnn/v1/headlines to list a section's stories for that month from CNN's archive, going back years. Archive entries carry the link, dates and lead image, and you can open any of them with /cnn/v1/article.

Does it return videos and live updates?+

Headlines include every story type (article, video, live updates, gallery, interactive) and you can filter by type. Full body text is available for articles; videos, galleries and live-updates pages have no article body.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /cnn/v1/headlines with section=politics. Docs and request examples are at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.

More news APIs all news APIs →

Start with 1,000 free credits

Every month, on every account. One key works for all 482 platforms.

Get a free API key