Real-Time News API for Developers

Q: How do I get an API key?

Sign up , verify your email address, and copy the API key from your dashboard . Your account starts on the Free plan. If you sign up with Google, your email address will be verified automatically.

Q: How far back does your historical data go?

To 2020 on paid plans, with the from and to parameters. The Free plan covers the last 30 days: older articles are left out, and the response says how many. See Article Availability in the documentation.

Q: Do I get the full article content?

Yes, on paid plans: content holds the full text of the article. On the Free plan, it's cut to 250 characters. On any plan, add truncate=content to get the shorter version.

Q: What happens when I reach my daily quota?

The API returns a 403 error until the quota resets at 00:00 UTC. Unused requests don't carry over to the next day. Follow your usage on the dashboard , and upgrade when you need a higher daily quota.

Q: Can I cancel my subscription at any time?

Yes, at no cost: Go to Plan & Billing . Click Cancel subscription . Choose a reason, then confirm. You'll keep your plan until the end of your billing period. After that, your account will move to the Free plan. Until your billing period ends, Resume subscription on the same page undoes the cancellation, and so does changing your plan. If you cancel before the trial ends, you won't be charged.

Search articles or get top headlines by category from 80,000+ sources in 41 languages and 71 countries, returned as JSON. Top headlines are based on Google News rankings. GNews API is built for news feeds, media monitoring, analytics, and AI agents. Start for free, then upgrade to get real-time articles, historical data since 2020, and full article content.

Get API key

View documentation

No credit card needed.

Try GNews API

{
    "totalArticles": 189621,
    "articles": [
        {
            "id": "1c898e6a0a2b4a0f20a6f5ea00f439aa",
            "title": "United Airlines blocks AI agents from booking flights",
            "description": "The airline said the use of artificial intelligence agents could violate regulations.",
            "content": "United Airlines says it will prevent artificial intelligence agents and assistants from booking flights, citing data and security concerns.\nThe company said in a news release Wednesday that sharing details with third-party AI assistants “can expose s... [8770 chars]",
            "url": "https://www.washingtonpost.com/travel/2026/11/12/united-airlines-blocks-ai-agents-booking-flights/",
            "image": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https%3A%2F%2Fcloudfront-us-east-1.images.arcpublishing.com%2Fwapo%2FNBUIZZXZ34PFNYJWD3GDBCVJXE.JPG&w=1200",
            "publishedAt": "2026-11-12T12:30:00Z",
            "lang": "en",
            "source": {
                "id": "f16dc396e088c7c707eabe9d7479e7a2",
                "name": "The Washington Post",
                "url": "https://www.washingtonpost.com",
                "country": "us"
            }
        },
        {
            "id": "249a02df5738485e75c06cd9c5df05b7",
            "title": "Hasbro Is Using AI to Bring Characters to Life",
            "description": "For the next time you need Cobra Commander to crash a Teams meeting.",
            "content": "Have you ever thought your day-to-day might be enhanced by a running commentary from Optimus Prime? Sixth Wall, the AI offshoot of Hasbro, has got great news for you.\nHold music replaced by chitchat with Mr. Monopoly, a digital personal assistant wit... [4368 chars]",
            "url": "https://www.cnet.com/tech/services-and-software/hasbro-sixth-wall-studio-ai-characters/",
            "image": "https://www.cnet.com/wp-content/uploads/sites/2/GettyImages-1496748930.jpg",
            "publishedAt": "2026-11-12T12:20:15Z",
            "lang": "en",
            "source": {
                "id": "6f4f13c21bb217801ab4b37c367f97aa",
                "name": "CNET",
                "url": "https://www.cnet.com",
                "country": "us"
            }
        },
        {
            "id": "02fbf13919c452aad59f3c2c408060b1",
            "title": "Spirit’s former flight attendants protect their data from Google.",
            "description": "The tech giant spent $10 million to buy a collection of internal data from defunct airline Spirit for AI training, which it said would be “deidentified.” A union representing attendants has made sure of that, persuading Google to agree to stricter terms excluding employee medical data, along with details on labor relations and safety investigations.\n[Link: Google Wanted Spirit Airlines Data. Flight Attendants Found a Way to Opt Out | https://www.wired.com/story/google-wanted-spirit-airlines-data-flight-attendants-found-a-way-to-opt-out/ | WIRED]",
            "content": "D\nExternal Link\nSpirit’s former flight attendants protect their data from Google.\nThe tech giant spent $10 million to buy a collection of internal data from defunct airline Spirit for AI training, which it said would be “deidentified.” A union repres... [806 chars]",
            "url": "https://www.theverge.com/transportation/1031845/spirits-former-flight-attendants-protect-their-data-from-google",
            "image": "https://platform.theverge.com/wp-content/uploads/sites/2/2025/01/verge-placeholder_f212b3.png?quality=90&strip=all&crop=0,0.13712291199202,100,99.725754176016",
            "publishedAt": "2026-11-12T12:19:54Z",
            "lang": "en",
            "source": {
                "id": "cb749b89c7dc92dc2d517a49bb9a43ab",
                "name": "The Verge",
                "url": "https://www.theverge.com",
                "country": "us"
            }
        }
    ]
}

United Airlines blocks AI agents from booking flights https://www.washingtonpost.com/travel/2026/11/12/united-airlines-blocks-ai-agents-booking-flights/

Hasbro Is Using AI to Bring Characters to Life https://www.cnet.com/tech/services-and-software/hasbro-sixth-wall-studio-ai-characters/

Spirit’s former flight attendants protect their data from Google. https://www.theverge.com/transportation/1031845/spirits-former-flight-attendants-protect-their-data-from-google

This preview searches English articles from US sources. To search other languages and countries, see Search Endpoint in the documentation.

Used by 150,000+ developers, including people and teams at

Quick to integrate

Every endpoint is documented with copy-paste examples, so your first request takes minutes.

Start for free

Build and test on the Free plan at no cost. Every paid plan starts with a 10-day free trial.

Fast, relevant articles

Articles are indexed in our own database ahead of time, never scraped on demand, so requests return in milliseconds.

Built for scale

Coverage that grows every day.

Articles indexed

100M+

News sources

80,000+

Languages

Live updates

24/7

Countries

Years of history

From request to
articles in seconds

Send one GET request and get JSON back, ready to use in your app. GNews API has two endpoints.

GET https://gnews.io/api/v4/search?q=AI&lang=en&apikey=YOUR_API_KEY

Find articles by keyword, with search operators and filters for language, country, and date range. Best for media monitoring, analytics, RAG pipelines, and research.

curl --get "https://gnews.io/api/v4/search" \
  --data-urlencode "q=AI" \
  --data-urlencode "lang=en" \
  --data-urlencode "apikey=YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"

response = requests.get(
    "https://gnews.io/api/v4/search",
    params={"q": "AI", "lang": "en", "apikey": API_KEY},
    timeout=10,
)
response.raise_for_status()

for article in response.json()["articles"]:
    print(article["title"])

const API_KEY = "YOUR_API_KEY";

const params = new URLSearchParams({
    q: "AI",
    lang: "en",
    apikey: API_KEY,
});

const response = await fetch(`https://gnews.io/api/v4/search?${params}`);
if (!response.ok) {
    throw new Error(`Request failed: ${response.status}`);
}

const { articles } = await response.json();
for (const article of articles) {
    console.log(article.title);
}

On the Free plan, CORS only allows localhost, so browsers block requests from a deployed website: see Using the API in the FAQ.

<?php

$apiKey = "YOUR_API_KEY";

$params = http_build_query([
    "q"      => "AI",
    "lang"   => "en",
    "apikey" => $apiKey,
]);

$response = file_get_contents("https://gnews.io/api/v4/search?" . $params);
if ($response === false) {
    throw new RuntimeException("Request failed");
}

$data = json_decode($response, true);
foreach ($data["articles"] as $article) {
    echo $article["title"] . PHP_EOL;
}

using System.Net.Http.Json;

const string ApiKey = "YOUR_API_KEY";

using var client = new HttpClient();

var url = $"https://gnews.io/api/v4/search?q=AI&lang=en&apikey={ApiKey}";
var data = await client.GetFromJsonAsync<ApiResponse>(url)
           ?? throw new InvalidOperationException("Empty response");

foreach (var article in data.Articles)
{
    Console.WriteLine(article.Title);
}

record ApiResponse(List<Article> Articles);
record Article(string Title);

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=business" \
  --data-urlencode "lang=en" \
  --data-urlencode "apikey=YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"

response = requests.get(
    "https://gnews.io/api/v4/top-headlines",
    params={"category": "business", "lang": "en", "apikey": API_KEY},
    timeout=10,
)
response.raise_for_status()

for article in response.json()["articles"]:
    print(article["title"])

const API_KEY = "YOUR_API_KEY";

const params = new URLSearchParams({
    category: "business",
    lang: "en",
    apikey: API_KEY,
});

const response = await fetch(`https://gnews.io/api/v4/top-headlines?${params}`);
if (!response.ok) {
    throw new Error(`Request failed: ${response.status}`);
}

const { articles } = await response.json();
for (const article of articles) {
    console.log(article.title);
}

On the Free plan, CORS only allows localhost, so browsers block requests from a deployed website: see Using the API in the FAQ.

<?php

$apiKey = "YOUR_API_KEY";

$params = http_build_query([
    "category" => "business",
    "lang"     => "en",
    "apikey"   => $apiKey,
]);

$response = file_get_contents("https://gnews.io/api/v4/top-headlines?" . $params);
if ($response === false) {
    throw new RuntimeException("Request failed");
}

$data = json_decode($response, true);
foreach ($data["articles"] as $article) {
    echo $article["title"] . PHP_EOL;
}

using System.Net.Http.Json;

const string ApiKey = "YOUR_API_KEY";

using var client = new HttpClient();

var url = $"https://gnews.io/api/v4/top-headlines?category=business&lang=en&apikey={ApiKey}";
var data = await client.GetFromJsonAsync<ApiResponse>(url)
           ?? throw new InvalidOperationException("Empty response");

foreach (var article in data.Articles)
{
    Console.WriteLine(article.Title);
}

record ApiResponse(List<Article> Articles);
record Article(string Title);

200 OK · JSON response

{
    "totalArticles": 466266,
    "articles": [
        {
            "id": "fbc6d910c61780a7103e02ea3bd6b13a",
            "title": "Could AI help reduce surgical backlogs?",
            "description": "The University of Manitoba is exploring whether AI can reduce surgical wait times in hospitals which remain a challenge for Manitoba’s health-care system.",
            "content": "WINNIPEG – The University of Manitoba is exploring whether AI can reduce surgical wait times in hospitals which remain a challenge for Manitoba’s health-care system.\nAccording to researchers, more than 1,300 people are facing the orthopedic surgery b... [3480 chars]",
            "url": "https://www.bnnbloomberg.ca/business/artificial-intelligence/2026/10/31/could-ai-help-reduce-surgical-backlog-manitoba-researchers-are-very-optimistic/",
            "image": "https://www.bnnbloomberg.ca/resizer/v2/5EEW25INGREYPLKHM6T32IN5C4.jpeg?smart=true&auth=f3cb9692eaf2f7a6ff46b516cbad3ad5a8baeb99935d6a3d71cae5d9d7dec167&width=1200&height=630",
            "publishedAt": "2026-10-31T09:00:00Z",
            "lang": "en",
            "source": {
                "id": "1b697445987e8a33f6c82842e17d60d9",
                "name": "Bnn Bloomberg",
                "url": "https://www.bnnbloomberg.ca",
                "country": "ca"
            }
        }
    ]
}

{
    "totalArticles": 2591572,
    "articles": [
        {
            "id": "2d3cb23bf0f910a124701d5cbfe869e3",
            "title": "Fault on key electricity link ahead of winter peak",
            "description": "Mutual Energy, which operates the Moyle Interconnector, says the cause is still being investigated, and it is not yet clear when it will be repaired.",
            "content": "Northern Ireland's electricity link with Great Britain has developed a fault, halving its capacity to import power ahead of peak winter demand.\nMutual Energy, which operates the undersea Moyle Interconnector, said the cause is still being investigate... [1851 chars]",
            "url": "https://www.yahoo.com/news/world/articles/fault-key-electricity-ahead-winter-084848169.html",
            "image": "https://s.yimg.com/lo/mysterio/api/6f57bec5d33e80641a16d43bec729d94c2daccc55361a91ec28c6d012307b6b1/lightyear_networkapi/resizefill_w1200%3Bquality_80%3Bformat_jpg/https%3A%2F%2Fmedia.zenfs.com%2Fen%2Fbbc_us_articles_995%2Fea20489016f6b9adc30f9cc634a13ba9.jpg",
            "publishedAt": "2026-10-31T08:48:48Z",
            "lang": "en",
            "source": {
                "id": "99e8a2cb4638bb798cf9167e5af5b83b",
                "name": "Yahoo",
                "url": "https://www.yahoo.com"
            }
        }
    ]
}

All the world's news, one API

A global news database, updated continuously, with historical data since 2020. Build your products and research on the same data 150,000+ developers use.

Worldwide scale

100 million+ articles from 80,000+ sources, in 41 languages and 71 countries. Filter by language or country to cover exactly the markets you need.

Rich article data

Every article comes structured: title, description, content, URL, image, publication date, language, and source. Extraction and quality checks keep each field clean and consistent.

Historical data

Every indexed article stays searchable. Paid plans reach back to 2020: more than 6 years of news history.

Real-time articles

Sources are crawled continuously. On paid plans, new articles are returned as soon as they're indexed.

Low latency

Requests return in 100–300 ms. We tune the infrastructure continuously to keep it that way at any volume.

Works with any language

Standard HTTP GET requests and JSON responses work from any programming language: send a request, parse the JSON, use the articles.

Stuck on your integration? Contact us.

Libraries, SDKs, and MCP server

Ship faster with the official SDKs for Python, JavaScript/TypeScript, and PHP. The LangChain tools and the MCP server bring real-time news into your AI agents.

View libraries

Missing a source?

Know a reliable news website that GNews API doesn't cover yet? Suggest it, and we'll review it for the index.

Suggest a missing source

Free academic access

Working on a thesis or an academic project? Students, researchers, and teachers can get the Essential plan for free.

Apply for academic access

Advanced request options

Build precise queries with search operators, then refine each request with optional parameters.

Search operators

Write queries for both endpoints with exact phrases, parentheses, and the AND, OR, and NOT operators.

Read the query syntax

Full article content

Get the full text of each article, not only the title and description. Included in every paid plan, for analysis, summarization, and AI pipelines.

Compare plans

What you can build with GNews API

From news feeds to AI agents, one API covers the news your product needs, with official libraries and examples to get started in a few lines of code.

News feeds

Add live headlines and articles to your website or app: news readers, newsletters, and front pages.

Media monitoring

Track coverage of any topic, company, brand, or person across 80,000+ sources as news breaks.

Analytics

Feed real-time and historical articles into dashboards, trading signals, risk models, and market analysis.

AI agents

Connect your agents to live news through the LangChain tools or the MCP server, so they work from current facts.

RAG pipelines

Ground your models in fresh, factual news for retrieval and summarization.

Academic research

Study media trends and narratives with years of structured, searchable articles.

Start in
three steps

View documentation

Sign up

Create your account in under a minute.

Copy your API key

Verify your email address, then copy the API key from your dashboard.

Make your first request

Send a GET request with your API key.

A plan for every project,
from first test to production

Monthly Yearly Save 20%

Free

€0

No credit card needed

For trying the API and for non-commercial projects

Non-commercial use
100 requests per day
Up to 10 articles per request
12-hour delay
Last 30 days of historical data
Content cut to 250 characters
CORS for localhost only
All 80,000+ sources

Start for free

Upgrade any time.

Essential

€49.99/month

Billed monthly

Business

€99.99/month

Billed monthly

For larger projects that need more requests and articles

Commercial use
5,000 requests per day
Up to 50 articles per request
Real-time articles
Historical data since 2020
Full article content
CORS for all origins
All 80,000+ sources
Email support
99.95% uptime SLA

Start 10-day free trial

You won't be charged for 10 days, then €99.99/month. Cancel any time.

Enterprise

€249.99/month

Billed monthly

For high-volume projects that need premium support

Commercial use
25,000 requests per day
Up to 100 articles per request
Real-time articles
Historical data since 2020
Full article content
CORS for all origins
All 80,000+ sources
Premium email support
99.95% uptime SLA

Start 10-day free trial

You won't be charged for 10 days, then €249.99/month. Cancel any time.

Free

€0

No credit card needed

For trying the API and for non-commercial projects

Non-commercial use
100 requests per day
Up to 10 articles per request
12-hour delay
Last 30 days of historical data
Content cut to 250 characters
CORS for localhost only
All 80,000+ sources

Start for free

Upgrade any time.

Essential

Instead of €49.99 €39.99/month

€479.99 billed yearly

Business

Instead of €99.99 €79.99/month

€959.99 billed yearly

For larger projects that need more requests and articles

Commercial use
5,000 requests per day
Up to 50 articles per request
Real-time articles
Historical data since 2020
Full article content
CORS for all origins
All 80,000+ sources
Email support
99.95% uptime SLA

Start 10-day free trial

You won't be charged for 10 days, then €959.99/year. Cancel any time.

Enterprise

Instead of €249.99 €199.99/month

€2,399.99 billed yearly

For high-volume projects that need premium support

Commercial use
25,000 requests per day
Up to 100 articles per request
Real-time articles
Historical data since 2020
Full article content
CORS for all origins
All 80,000+ sources
Premium email support
99.95% uptime SLA

Start 10-day free trial

You won't be charged for 10 days, then €2,399.99/year. Cancel any time.

Need more?

Get a custom plan

When the standard plans don't fit your volume or your use case, we build a plan around your project. It starts from the Essential plan, and you decide what changes.

You choose

Daily quota
Articles per request
Support level
Features beyond the standard plans

FAQ

What is GNews API?

GNews API is a real-time news API for developers. Search articles or get top headlines by category from 80,000+ sources in 41 languages and 71 countries, returned as JSON. Developers build news feeds, media monitoring tools, analytics, AI agents, RAG pipelines, and research projects on it. You can start on the Free plan.

How do I get an API key?

Sign up, verify your email address, and copy the API key from your dashboard. Your account starts on the Free plan. If you sign up with Google, your email address will be verified automatically.

How can I test paid features before subscribing?

Start the 10-day free trial of any paid plan from the Pricing page. You add a payment method. If you cancel before the trial ends, you won't be charged. The trial is available once per account. If the trial doesn't become a paid subscription, you can't use any data retrieved during it for commercial purposes.

Can I use the Free plan for a commercial project?

No. A commercial project requires a paid plan for as long as it uses GNews API. The Free plan is for personal, academic, evaluation, and other non-commercial projects. Developing and testing an integration that isn't published or in production yet isn't commercial use. Commercial use means any product, service, or project that is sold, earns revenue, or is used in the course of a business. Accounts that break this rule can be suspended or closed. Full conditions are in the Terms of Service.

How far back does your historical data go?

To 2020 on paid plans, with the from and to parameters. The Free plan covers the last 30 days: older articles are left out, and the response says how many. See Article Availability in the documentation.

Do I get the full article content?

Yes, on paid plans: content holds the full text of the article. On the Free plan, it's cut to 250 characters. On any plan, add truncate=content to get the shorter version.

Can I filter articles by source?

Not yet. Source filtering is on our roadmap. Every article includes a source object (name, home page URL, and, on the Search endpoint, country), so you can filter or group articles on your side.

What happens when I reach my daily quota?

The API returns a 403 error until the quota resets at 00:00 UTC. Unused requests don't carry over to the next day. Follow your usage on the dashboard, and upgrade when you need a higher daily quota.

Can I cancel my subscription at any time?

Yes, at no cost:

Go to Plan & Billing.
Click Cancel subscription.
Choose a reason, then confirm.

You'll keep your plan until the end of your billing period. After that, your account will move to the Free plan. Until your billing period ends, Resume subscription on the same page undoes the cancellation, and so does changing your plan. If you cancel before the trial ends, you won't be charged.

What is the refund policy?

You can ask for a refund within 7 days of your initial subscription or of a renewal, if you haven't made any request in that period. When you subscribe without a free trial, the first month's payment can't be refunded. Write to contact@gnews.io with a short explanation. We aim to review requests within 3 to 5 business days, and an approved refund usually reaches your account 5 to 10 business days later. Requests we consider fraudulent or abusive can be refused. Full details are in the Terms of Service.

Why can't I verify my email address?

Verification codes expire after 15 minutes. Request a new code on the Verify Your Email Address page, which opens when you sign in, and check your spam folder. If it still fails, write to contact@gnews.io from the address you signed up with, and we'll verify it for you.

How do I contact support?

Write to contact@gnews.io, use the contact form, or start a chat. Paid plans include email support: a reply within 1 business day, and help with your integration. The Enterprise plan includes premium email support: priority replies, and advanced help with your integration, such as query design and data pipelines.

Looking for something else? See all frequently asked questions.

Ready to build
with GNews API?

Get your API key and make your first request in minutes.

Get API key View documentation

Real-Time News API for Developers

Try GNews API

Quick to integrate

Start for free

Fast, relevant articles

Built for scale

From request to articles in seconds

All the world's news, one API

Worldwide scale

Rich article data

Historical data

Real-time articles

Low latency

Works with any language

Libraries, SDKs, and MCP server

Missing a source?

Free academic access

Advanced request options

Search operators

Full article content

What you can build with GNews API

News feeds

Media monitoring

Analytics

AI agents

RAG pipelines

Academic research

Start in three steps

Sign up

Copy your API key

Make your first request

A plan for every project, from first test to production

Free

Essential

Business

Enterprise

Free

Essential

Business

Enterprise

Get a custom plan

FAQ

Ready to build with GNews API?

From request to
articles in seconds

Start in
three steps

A plan for every project,
from first test to production

Ready to build
with GNews API?