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 . You start on the Free plan, with no credit card. If you sign up with Google, there is no email to verify.

Q: How far back does your historical data go?

To 2020 on paid plans, with the from and to parameters. On the Free plan, you get 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 is 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 403 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 more requests per day.

Q: Can I cancel my subscription at any time?

Yes, at no cost: Go to Plan & Billing . Click Cancel subscription . Pick a reason, then confirm. You keep your plan until the end of the period you've paid for; your account then moves to the Free plan. Until that date, Resume subscription on the same page undoes the cancellation, and so does changing your plan. If you cancel during a trial, you won't be charged.

Search articles from 80,000+ sources, or get top headlines by category in 41 languages and 71 countries, returned as JSON. Use it for news feeds, media monitoring, analytics, and AI agents.

Get API key

View documentation

No credit card needed to get your API key.

Try GNews API

{
    "totalArticles": 187307,
    "articles": [
        {
            "id": "418c9226086b8ad3fd048b40150ca7be",
            "title": "South Korea will nearly double AI spending to $16B in a record budget",
            "description": "South Korea will spend about $16B on AI, chips and data centres in 2027, plus 4.7 trillion won on its own AI model, President Lee Jae Myung said.",
            "content": "South Korea will spend 21.3 trillion won (about $16 billion) on AI, chips and AI data centres next year. President Lee Jae Myung set out the plan in his budget speech to the National Assembly on Monday.\n“We will invest 21.3 trillion won, nearly twice... [1902 chars]",
            "url": "https://thenextweb.com/news/south-korea-2027-budget-ai-chips-data-centres-21-trillion-won",
            "image": "https://media.thenextweb.com/2026/11/lee-jae-myung-donald-trump-oval-office-2025.jpg",
            "publishedAt": "2026-11-04T12:43:46Z",
            "lang": "en",
            "source": {
                "id": "11c2fbf226e7334e9f93bb78243a79cc",
                "name": "TNW",
                "url": "https://thenextweb.com",
                "country": "us"
            }
        },
        {
            "id": "aa5d2f24ca1dae59fd35308f55707433",
            "title": "Elon Musk spends $474 million elections but loses big as Democrats sweep midterms and voters reject AI data centers",
            "description": "Elon Musk spent at least $474 million trying to influence the 2026 midterm elections. By Wednesday morning, November 4, much of that money had gone into losing races, as Democrats swept into control of Congress and voters delivered another warning to an industry pouring trillions into artificial intelligence and data centers. The election dealt a",
            "content": "Elon Musk spent at least $474 million trying to influence the 2026 midterm elections. By Wednesday morning, November 4, much of that money had gone into losing races, as Democrats swept into control of Congress and voters delivered another warning to... [5877 chars]",
            "url": "https://techstartups.com/2026/11/04/elon-musk-spends-474-million-but-loses-big-as-democrats-sweep-midterms-and-voters-reject-ai-data-centers/",
            "image": "https://techstartups.com/wp-content/uploads/2022/06/musk-king-960x626.jpg",
            "publishedAt": "2026-11-04T12:35:29Z",
            "lang": "en",
            "source": {
                "id": "a3b1ce1267ce02959f0b6a7bc018cec4",
                "name": "TechStartups.com",
                "url": "https://techstartups.com",
                "country": "us"
            }
        },
        {
            "id": "8037edbc5d8620addc2b3c9cc7c2da0b",
            "title": "Aramco’s profit rises to $31.2B as it takes 49% of Saudi AI firm HUMAIN",
            "description": "‘The HUMAIN deal is very important to Aramco,’ says CEO Amin Nasser, as the oil giant’s adjusted net income rises to $31.2 billion.",
            "content": "Saudi Aramco’s adjusted net income rose to $31.2 billion in the third quarter, from $28.6 billion a year earlier. The state oil company reported the figures in its results on Tuesday. Its report also highlights a new 49% stake in HUMAIN, Saudi Arabia... [2070 chars]",
            "url": "https://thenextweb.com/news/aramco-humain-49-percent-stake-q3-2026-profit",
            "image": "https://media.thenextweb.com/2026/11/aramco-workers-hard-hats-storage-tank-logo.jpg",
            "publishedAt": "2026-11-04T12:34:15Z",
            "lang": "en",
            "source": {
                "id": "11c2fbf226e7334e9f93bb78243a79cc",
                "name": "TNW",
                "url": "https://thenextweb.com",
                "country": "us"
            }
        }
    ]
}

South Korea will nearly double AI spending to $16B in a record budget https://thenextweb.com/news/south-korea-2027-budget-ai-chips-data-centres-21-trillion-won

Elon Musk spends $474 million elections but loses big as Democrats sweep midterms and voters reject AI data centers https://techstartups.com/2026/11/04/elon-musk-spends-474-million-but-loses-big-as-democrats-sweep-midterms-and-voters-reject-ai-data-centers/

Aramco’s profit rises to $31.2B as it takes 49% of Saudi AI firm HUMAIN https://thenextweb.com/news/aramco-humain-49-percent-stake-q3-2026-profit

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

Used by more than 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

Start any paid plan with a 10-day free trial, or build and test on the Free plan at no cost.

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, browsers can only call the API from localhost: 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, browsers can only call the API from localhost: 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 around the clock, with historical data since 2020. Build your products and research on the same data more than 150,000 developers use.

Worldwide scale

100M+ 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 around the clock. On paid plans, new articles are returned as soon as they are indexed.

Low latency

Response time is a priority: we tune the infrastructure continuously to keep every request fast, 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 MCP server and LangChain tools bring real-time news into your AI agents.

See the 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

Combine, separate, and exclude keywords with AND, OR, and NOT, and match exact phrases with quotes.

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 thousands of 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 MCP server or the LangChain tools, 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, no credit card needed.

Copy your API key

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

Make your first request

Send a GET request and get JSON back, ready for your app.

A plan for every project,
from first test to production

Monthly Yearly Save 20%

Free

€0

No credit card needed

For development, testing, and 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

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

Then €249.99/month. Cancel any time.

Free

€0

No credit card needed

For development, testing, and 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

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

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?

A REST API that returns news articles as JSON, so you don't have to run a crawler. The Search endpoint queries 80,000+ sources by keyword, and the Top Headlines endpoint returns the leading articles of a category in 41 languages and 71 countries. 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. You start on the Free plan, with no credit card. If you sign up with Google, there is no email to verify.

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, and if you cancel before the trial ends, you won't be charged. The trial is available once per account. You can't use data retrieved during a trial that doesn't become a paid subscription for commercial purposes.

Can I use the Free plan for a commercial project?

No. A commercial project needs a paid plan for as long as it uses GNews API. The Free plan is for personal, academic, evaluation, and other non-commercial use; developing and testing an integration that isn't published or in production yet is not 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. On the Free plan, you get 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 is 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 403 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 more requests per day.

Can I cancel my subscription at any time?

Yes, at no cost:

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

You keep your plan until the end of the period you've paid for; your account then moves to the Free plan. Until that date, Resume subscription on the same page undoes the cancellation, and so does changing your plan. If you cancel during a trial, 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. A first payment made without a free trial can't be refunded. Email contact@gnews.io with a short explanation. We 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 verification 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?

Email contact@gnews.io or use the contact form. Paid plans include email support, and the Enterprise plan includes premium email support.

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?