🔑 How to get a free GNews API key
GNews issues keys instantly on signup — the free tier is enough for prototypes and small tools.
- Create an account. Sign up at gnews.io — no card required for the free tier.
- Copy your API key. It's shown on your dashboard immediately.
- Make a request. GET https://gnews.io/api/v4/search?q=bitcoin&lang=en&apikey=YOUR_KEY or /top-headlines for category feeds.
- Mind the free limits. Free tier: about 100 requests/day, 10 articles per response, and truncated article content.
📚 Documentation & Examples
Everything you need to integrate with GNews
🚀 Quick Start Examples
// GNews API Example
const response = await fetch('https://gnews.io/', {
method: 'GET',
headers: {
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);The news search API from Gnews.io provides an efficient way to access the latest articles from various reliable sources. With the ability to filter by topics, sources, and even regions, developers can integrate up-to-date news content into their applications seamlessly. This API not only offers an extensive database of news articles but also employs advanced search functionalities that make it easier for users to find specific information. Whether you are developing a news aggregator app, a content curation tool, or any application that requires real-time news updates, the Gnews.io API is an invaluable resource for sourcing information.
Leveraging the Gnews.io API can significantly enhance your application's value by providing users with timely and relevant news content. Here are some benefits of utilizing this API:
- Access to a wide range of news articles from numerous sources
- Customizable search filters to refine results by keyword or category
- Real-time updates to ensure users receive the latest news
- User-friendly integration and comprehensive documentation
- Global coverage of news articles, including localization options
Here’s a simple JavaScript code example demonstrating how to call the Gnews.io API:
const fetch = require('node-fetch');
const API_KEY = 'YOUR_API_KEY';
const query = 'latest news';
const url = `https://gnews.io/api/v4/search?q=${encodeURIComponent(query)}&token=${API_KEY}`;
fetch(url)
.then(response => response.json())
.then(data => {
console.log('News Articles:', data.articles);
})
.catch(error => {
console.error('Error fetching news:', error);
});
How to Get a GNews API Key
- Sign up for free at gnews.io/register — no credit card required.
- Verify your email address.
- Open your dashboard to find your API key.
The free plan allows 100 requests per day (about 1 request/second) and returns up to 10 articles per request. The free tier returns article metadata with truncated content, not full article bodies; larger quotas and full content require a paid plan. Your daily counter resets at 00:00 UTC.
Authenticate by adding your key as the apikey query parameter (older examples use token, which still works):
const apiKey = 'YOUR_API_KEY';
const url = `https://gnews.io/api/v4/search?q=technology&lang=en&max=5&apikey=${apiKey}`;
fetch(url).then(res => res.json()).then(data => console.log(data.articles));
❓ Frequently Asked Questions
Is the GNews API free?
There's a free tier of roughly 100 requests/day with 10 articles per response. Paid plans raise volume, unlock full article content, and add CORS for browser use.
What are alternatives to the GNews API?
NewsAPI.org (free for development only), NewsData.io, Mediastack, and The Guardian's free API are the usual comparisons — see this page's alternatives link.
