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

Request
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.

Visual Guide

Getting Your API Key — Step by Step

Create your account

GNews signup form with numbered annotations: 1 the email address field, 2 the password field, and 3 the Sign up button
Screenshot of gnews.io (July 2026), annotated by APIs Score
  • 1 Enter your email address.
  • 2 Choose a password (or use the Sign up with Google option below the form).
  • 3 Click Sign up, then verify your email address. Once verified, your API key is waiting on your dashboard.

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

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

Technical Specifications

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

Related Tags

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 →