GNews API

⭐ Beginner's Pick News / API Key Intermediate HTTPS CORS
Varies by plan (check documentation)

Overview

GNews is a news search API that aggregates articles from thousands of sources worldwide and lets you filter by keyword, language, country, and topic. It is developer-friendly with a straightforward REST interface and clear documentation. The free plan provides 100 requests per day, which is plenty for getting started.

💡

Beginner Tip

Use the q parameter for keyword searches and always specify lang=en to filter English results for more consistent output. Cache your API responses locally to avoid hitting the daily request limit during development.

Available Data

article title and content
publication source
published date
article URL
image URL

Example Response

JSON Response
{
  "totalArticles": 100,
  "articles": [
    {
      "title": "Tech Industry Sees Record Growth",
      "source": {
        "name": "TechNews",
        "url": "https://technews.com"
      },
      "publishedAt": "2025-01-15T08:00:00Z",
      "description": "The technology sector reported unprecedented growth...",
      "image": "https://example.com/article-image.jpg",
      "url": "https://technews.com/article/123"
    }
  ]
}

Field Reference

articles List of news articles matching the search query
articles[].title Headline of the article
articles[].description Short summary or lead sentence of the article
articles[].url Direct link to the full article on the original site
articles[].publishedAt ISO 8601 publication timestamp of the article
articles[].source.name Name of the news outlet or publication

Implementation Example

const url = "https://gnews.io/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

403 Forbidden - token invalid API token is missing, incorrect, or not yet activated
Double-check the token parameter in your URL and verify it in your GNews dashboard
429 - Daily limit reached The 100 requests/day free tier quota has been used up
Wait until midnight UTC for the limit to reset, or upgrade to a paid plan
Missing or empty articles array No articles found for the given keyword and filters
Broaden your search query or remove restrictive country/language filters

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 5/20
🔒 Security 15/15
🛠 Developer XP 17/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS YES
Category News
Difficulty Intermediate
Verified: 2026-04-04

Alternatives to GNews

Technical alternatives for different use cases.

Completely free news API with decent coverage

Better For

Free news data for hobby and learning projects

Trade-off

Source quality and reliability guarantees

Apilayer-backed news from 7,500+ sources worldwide

Better For

International news coverage in 50+ languages

Trade-off

Free tier (limited free plan)

More sources and advanced search operators

Better For

Complex news queries with boolean search

Trade-off

Free tier for production applications

Recipes Using GNews

Build something with this API. Each recipe includes step-by-step instructions and code outlines.

Similar APIs

View All →