Real-Time News API with Full Article Content and an Archive Back to 2020

Q: How do I get an API key?

Create an account at gnews.io/register , confirm your email address, and your API key is waiting on your dashboard . It works immediately on the Free plan, no credit card required.

Q: Do I get the full article content?

Yes, on paid plans the content field contains the full text of the article. On the Free plan the content is truncated to a short excerpt. You can also request a truncated excerpt on any plan by adding truncate=content to your request.

Q: What happens when I reach my plan's request limit?

Once the daily limit is reached, the API answers 403 Forbidden and returns no more data until the counter resets, which happens every day at 00:00 UTC. Unused requests do not carry over to the next day. You can follow your usage on your dashboard , and upgrade at any time from Change plan if you need more headroom.

Q: Can I cancel my subscription at any time?

Yes, at any time and at no extra cost: Open Plan & Billing . In the Subscription section, click Cancel subscription . Tell us in a few words why you are leaving, then confirm. You keep full access until the end of the period you have already paid for, and your account then returns to the Free plan. Changed your mind before that date? Click Resume subscription on the same page. Cancelling during a free trial means you are never charged.

Search real-time articles from 80,000+ trusted sources across 41 languages and 71 countries, and tap into years of historical news going back to 2020, all delivered in clean JSON that is ready to use. Build news monitoring, aggregation, and analytics features in minutes, not weeks.

Get API key

View documentation

Start on the free tier instantly, no credit card needed.

Try GNews API

{
    "totalArticles": 95507,
    "articles": [
        {
            "id": "019d061e5ad32cb535ecad7eabadd1b4",
            "title": "Searching 'The Legend of Zelda' on Google Takes You Back to 1998",
            "description": "What happens when you search 'The Legend of Zelda' on Google? Ahead of the release of The Legend of Zelda: Ocarina of Time, Google brings a bit of time-reversing magic.",
            "content": "What happens when you search 'The Legend of Zelda' on Google? Ahead of the release of The Legend of Zelda: Ocarina of Time, Google brings a bit of time-reversing magic.\nSearching for 'The Legend of Zelda' or 'Ocarina of Time' on Google currently reve... [1295 chars]",
            "url": "https://www.invenglobal.com/articles/28049/searching-the-legend-of-zelda-on-google-takes-you-back-to-1998",
            "image": "https://static.invenglobal.com/upload/image/2026/11/02/i1793610126668208.jpeg",
            "publishedAt": "2026-11-02T09:00:48Z",
            "lang": "en",
            "source": {
                "id": "e8d7ea30b7c7cf50d2b88be83a09a0fa",
                "name": "InvenGlobal",
                "url": "https://www.invenglobal.com",
                "country": "us"
            }
        },
        {
            "id": "58b971bf6d880633cd18f511adfa8369",
            "title": "Asian shares mostly advance but tech stocks remain volatile, while oil sinks 3.3%",
            "description": "Asian shares are mostly higher but technology stocks remain volatile. Oil prices fell sharply on renewed possibilities for diplomatic efforts between the U.S. and Iran. U.S. futures edged higher after Wall Street logged its worst day since June on Friday as investors dumped technology- and artificial intelligence-related stocks. Technology stocks have been hit by waves of selling due to growing worries that the AI buildup may be a bubble. This week brings more earnings, with results later Monday for Apple. Last week, Google parent Alphabet Inc. and Amazon rattled markets with their earnings reports.  On Friday, Wall Street’s benchmark S&P 500 fell 1.8%. The technology-heavy Nasdaq composite declined 2.9%, while the Dow Jones Industrial Average slid 1.1%.",
            "content": "HONG KONG (AP) — Asian shares were mostly higher Monday but technology stocks remained volatile, while oil prices fell more than 3%.\nU.S. futures edged higher after Wall Street fell Friday to its worst day since June as investors dumped technology- a... [464 chars]",
            "url": "https://www.ajc.com/news/2026/11/asian-shares-mostly-advance-but-tech-stocks-remain-volatile-while-oil-sinks-33/",
            "image": "https://images.ajc.com/resizer/v2/CGBMPLHAMVC3RHMF3F6EYCHVIE.jpg?auth=0a0afff5e3d6ca80e213417f188b708d72dca70b568282306fd03ad7eea2c5ac&width=1200&height=630&smart=true",
            "publishedAt": "2026-11-02T05:32:52Z",
            "lang": "en",
            "source": {
                "id": "79e9a45376a66fd7e1a4e68bba928c39",
                "name": "The Atlanta Journal-Constitution",
                "url": "https://www.ajc.com",
                "country": "us"
            }
        },
        {
            "id": "b9a05519c1989e61146cc4c4f6b130e4",
            "title": "6 Google Maps Features That Work Better On Android Auto Vs. CarPlay",
            "description": "Android Auto offers Google Maps features that are either lacking or difficult to access using CarPlay. iPhone users navigating through CarPlay are missing out.",
            "content": "Google Maps is available on both Android Auto and Apple CarPlay, but it's not the same experience — even when using the same app in the same car. I performed identical searches, route changes and simple navigation tasks back to back on both systems u... [5265 chars]",
            "url": "https://www.engadget.com/2300327/google-maps-features-work-better-android-auto-vs-carplay/",
            "image": "https://www.engadget.com/img/gallery/6-google-maps-features-that-work-better-on-android-auto-vs-carplay/l-intro-1793216852.jpg",
            "publishedAt": "2026-11-02T01:00:00Z",
            "lang": "en",
            "source": {
                "id": "549a7a859b2345bbe231b00e7244ef99",
                "name": "Engadget",
                "url": "https://www.engadget.com",
                "country": "us"
            }
        }
    ]
}

Searching 'The Legend of Zelda' on Google Takes You Back to 1998 https://www.invenglobal.com/articles/28049/searching-the-legend-of-zelda-on-google-takes-you-back-to-1998

Asian shares mostly advance but tech stocks remain volatile, while oil sinks 3.3% https://www.ajc.com/news/2026/11/asian-shares-mostly-advance-but-tech-stocks-remain-volatile-while-oil-sinks-33/

6 Google Maps Features That Work Better On Android Auto Vs. CarPlay https://www.engadget.com/2300327/google-maps-features-work-better-android-auto-vs-carplay/

* Search results are in English and US sources only. For other languages/regions, see documentation at docs.gnews.io.

Trusted by more than 150,000 developers, including at

Easy-to-use

Clear, comprehensive documentation walks you through every endpoint, with copy-paste examples that get you to your first request in minutes.

Start for free

Build and test your applications at no cost during development. When you're ready to deploy to production, you can activate your subscription in minutes.

Fast, accurate responses

Every article is indexed in our own database, so queries return in milliseconds with results ranked for relevance, never scraped on demand.

Built for scale

Live coverage that keeps growing every day in 2026.

Articles indexed

100M+

News sources

80,000+

Languages

Live updates

24/7

Countries

Years of history

From request to
response in seconds

Make your first call with a single GET request and get back clean JSON you can drop straight into your app. GNews API gives you two endpoints.

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

Query the entire archive by keyword, with filters for language, country, and date range. Best for monitoring and research.

curl --get "https://gnews.io/api/v4/search" \
  --data-urlencode "q=Apple" \
  --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": "Apple", "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: "Apple",
    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);
}

<?php

$apiKey = "YOUR_API_KEY";

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

$response = file_get_contents("https://gnews.io/api/v4/search?" . $query);
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=Apple&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=technology" \
  --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": "technology", "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: "technology",
    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);
}

<?php

$apiKey = "YOUR_API_KEY";

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

$response = file_get_contents("https://gnews.io/api/v4/top-headlines?" . $query);
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=technology&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": 54231,
    "articles": [
        {
            "id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
            "title": "Apple unveils the iPhone 17 lineup at its fall event",
            "description": "The company showed new models, a faster chip, and camera upgrades.",
            "content": "Apple introduced its new iPhone lineup on Tuesday at its annual fall event, led by a faster chip and upgraded cameras across the range. Preorders open this week and devices ship later this... [1654 chars]",
            "url": "https://www.theverge.com/apple-iphone-17",
            "image": "https://cdn.example.com/iphone-17.jpg",
            "publishedAt": "2026-06-28T12:00:00Z",
            "lang": "en",
            "source": {
                "id": "f9e8d7c6b5a4f9e8d7c6b5a4f9e8d7c6",
                "name": "The Verge",
                "url": "https://www.theverge.com",
                "country": "us"
            }
        }
    ]
}

{
    "totalArticles": 38492,
    "articles": [
        {
            "id": "b2c3d4e5f6a7b2c3d4e5f6a7b2c3d4e5",
            "title": "New chip delivers faster on-device AI",
            "description": "The processor targets phones and laptops with lower power use.",
            "content": "The chipmaker unveiled a processor aimed at phones and laptops that runs AI models locally with lower power draw. The company said devices using the chip will arrive... [1356 chars]",
            "url": "https://techcrunch.com/on-device-ai-chip",
            "image": "https://cdn.example.com/ai-chip.jpg",
            "publishedAt": "2026-06-28T08:30:00Z",
            "lang": "en",
            "source": {
                "id": "c3d4e5f6a7b8c3d4e5f6a7b8c3d4e5f6",
                "name": "TechCrunch",
                "url": "https://techcrunch.com"
            }
        }
    ]
}

All the world's news, one API

Access a global news database with live updates and extensive historical archives to power your business applications and use cases. It is the news data infrastructure thousands of developers rely on in 2026.

Worldwide scale

Our database features more than 100 million articles from 80,000+ trusted sources in 41 languages across 71 countries. Use our filters to search by language or source country for precise global media coverage.

Rich article data

Every result comes fully structured, with the title, description, full article content, source, publication date, image, URL, and language. Rigorous extraction and continuous quality checks keep the data clean and consistent.

Historical data

Our database maintains a permanent archive of all indexed articles, providing access to years of historical data. Our coverage spans from 2020 to the present, giving you over 6 years of searchable news history.

Live news articles

Our continuous crawling system automatically retrieves new articles from all covered sources. Articles are immediately indexed and made available through the API upon discovery.

Response performance

Low response time is a core priority. We continuously tune our infrastructure to keep latency minimal on every request, at any scale.

Easy integration

Retrieve API results in JSON format through standard HTTP GET requests from any programming language. Integration is straightforward: send a request, receive results, parse the JSON response, and implement the data in your application.

Having trouble integrating the API? Contact us

Libraries, SDKs & MCP Server

Launch your applications faster with our official SDKs for Python, JavaScript, TypeScript and PHP. Our MCP server and LangChain tools bring real-time news directly into your AI agents, and ready-to-use examples get you up and running in minutes.

Discover the libraries

Missing Sources?

Help us expand our global news coverage. If you know of a reliable news website that isn't yet included in the GNews API, we welcome your suggestions. Community contributions help us maintain a diverse, accurate, and up-to-date news database.

Add missing sources

Student Access

Are you a student working on a project or thesis? We offer free access to the GNews API for academic use. Submit your request and get started with real-world news data for your project or thesis.

Request access

Advanced Request Options

Build precise queries with logical search operators, then refine every request with a wide range of optional parameters.

Search operators

Perform advanced searches using search operators such as AND, OR, and NOT to combine, separate, and exclude keywords.

Go to documentation

Access full content

Go beyond headlines and snippets and retrieve the full text of each article. Full content comes standard on every paid plan, ideal for analysis, summarization, and AI pipelines.

View plans

Integrate GNews API in minutes

GNews API fits seamlessly into your development workflow. With official libraries and easy-to-follow examples, you can start fetching news data in your favorite language with just a few lines of code.

Media monitoring

Track coverage of any topic, company, or person across thousands of outlets as stories break.

Brand and reputation tracking

See what the press is saying about your brand and respond quickly to emerging narratives.

Financial and market research

Feed live and historical headlines into trading signals, risk models, and market analysis.

AI, LLMs, and RAG

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

News aggregation apps

Build readers, newsletters, and dashboards on a single global news feed.

Academic research

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

Start in three
simple steps

Go to documentation

Create your free account

Grab your API key

Your key is ready in the dashboard the moment you sign in.

Make your first request

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

Find the Right Plan
for Your Needs

Monthly

Yearly Save 20%

Free

€0

For development, testing and non-commercial projects

Non-commercial use only
100 requests per day
Up to 10 articles returned per request
12-hour delay
30 days historical data
CORS enabled for localhost
Access to all sources

Start for free

Essential

€49.99/month

Business

€99.99/month

For larger projects that require more resources

Commercial use allowed
5,000 requests per day
Up to 50 articles returned per request
Real-time article availability
Historical data from 2020
CORS enabled for all origins
Access to all sources
Email support
Full article content
99.95% uptime SLA

Start 10-day free trial

Enterprise

€249.99/month

For enterprise projects that require exceptional resources

Commercial use allowed
25,000 requests per day
Up to 100 articles returned per request
Real-time article availability
Historical data from 2020
CORS enabled for all origins
Access to all sources
Premium email support
Full article content
99.95% uptime SLA

Start 10-day free trial

Free

€0

For development, testing and non-commercial projects

Non-commercial use only
100 requests per day
Up to 10 articles returned per request
12-hour delay
30 days historical data
CORS enabled for localhost
Access to all sources

Start for free

Essential

€49.99 €39.99/month

€479.99 billed annually

Business

€99.99 €79.99/month

€959.99 billed annually

For larger projects that require more resources

Commercial use allowed
5,000 requests per day
Up to 50 articles returned per request
Real-time article availability
Historical data from 2020
CORS enabled for all origins
Access to all sources
Email support
Full article content
99.95% uptime SLA

Start 10-day free trial

Enterprise

€249.99 €199.99/month

€2,399.99 billed annually

For enterprise projects that require exceptional resources

Commercial use allowed
25,000 requests per day
Up to 100 articles returned per request
Real-time article availability
Historical data from 2020
CORS enabled for all origins
Access to all sources
Premium email support
Full article content
99.95% uptime SLA

Start 10-day free trial

Missing something?

Create Your Own Plan

We'll create a custom plan designed around your specific requirements. Starting from any plan, Essential and above, you can customize:

Number of requests per day
Number of articles returned per request

Your support level
Request additional features

FAQ

GNews API is a REST API that lets you search and retrieve news articles from over 80,000 sources worldwide. Results come back as clean, structured JSON, so you can build news feeds, monitoring dashboards, market and brand tracking, research datasets, or AI pipelines without running your own crawler.

Create an account at gnews.io/register, confirm your email address, and your API key is waiting on your dashboard. It works immediately on the Free plan, no credit card required.

Every paid plan comes with a 10-day free trial that unlocks all of its features. Start it from Change plan; you will be asked for a payment method but nothing is charged during the trial, and cancelling before it ends costs you nothing. Data retrieved during a trial that does not turn into a paid subscription is for non-commercial use only. The trial is available once per account.

No. A commercial project needs an active paid plan for as long as it uses GNews API. On the Free plan, you may use the API and its data for personal, academic, evaluation and other non-commercial purposes only. Commercial use means any product, application, service or project that is offered for sale, generates revenue, or is used in the course of a business. Developing and testing an integration that has not been published or put into production is not commercial use. We may suspend or terminate accounts that violate these terms. See our Terms of Service for the full conditions.

Our archive goes back to 2020. Paid plans can query the whole archive with the from and to parameters. On the Free plan, results are limited to the last 30 days; older articles are removed from the response and the API tells you how many were dropped.

Yes, on paid plans the content field contains the full text of the article. On the Free plan the content is truncated to a short excerpt. You can also request a truncated excerpt on any plan by adding truncate=content to your request.

Not yet. Source filtering is on our roadmap. In the meantime, every article carries its source object (name, homepage URL and, on the Search endpoint, country), so you can filter or group results on your side.

Once the daily limit is reached, the API answers 403 Forbidden and returns no more data until the counter resets, which happens every day at 00:00 UTC. Unused requests do not carry over to the next day. You can follow your usage on your dashboard, and upgrade at any time from Change plan if you need more headroom.

Yes, at any time and at no extra cost:

Open Plan & Billing.
In the Subscription section, click Cancel subscription.
Tell us in a few words why you are leaving, then confirm.

You keep full access until the end of the period you have already paid for, and your account then returns to the Free plan. Changed your mind before that date? Click Resume subscription on the same page. Cancelling during a free trial means you are never charged.

You can request a refund within 7 days of your initial subscription or of a renewal, provided you have not made any API call in that period. Email contact@gnews.io with a short explanation; we review requests within 3 to 5 business days and approved refunds usually reach your account 5 to 10 business days later. Requests we consider fraudulent or abusive may be denied. Full details are in our Terms of Service.

First request a new verification email from your dashboard and check your spam folder, as the link in older emails expires. If it still does not work, write to contact@gnews.io from the address you signed up with and we will activate the account for you.

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

Looking for something else? See all frequently asked questions.

Ready to build
with GNews API?

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

Get API key Go to documentation

Real-Time News API with Full Article Content and an Archive Back to 2020

Try GNews API

Trusted by more than 150,000 developers, including at

Easy-to-use

Start for free

Fast, accurate responses

Built for scale

From request to response in seconds

All the world's news, one API

Worldwide scale

Rich article data

Historical data

Live news articles

Response performance

Easy integration

Libraries, SDKs & MCP Server

Missing Sources?

Student Access

Advanced Request Options

Search operators

Access full content

Integrate GNews API in minutes

Media monitoring

Brand and reputation tracking

Financial and market research

AI, LLMs, and RAG

News aggregation apps

Academic research

Start in three simple steps

Create your free account

Grab your API key

Make your first request

Find the Right Plan for Your Needs

Free

Essential

Business

Enterprise

Free

Essential

Business

Enterprise

FAQ

Ready to build with GNews API?

From request to
response in seconds

Start in three
simple steps

Find the Right Plan
for Your Needs

Ready to build
with GNews API?