TheNews API

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

Overview

TheNewsAPI is a news aggregation API that delivers headlines, top stories, and live news in JSON format from thousands of sources worldwide. It supports filtering by topic, language, country, and source, making it easy to build news feeds tailored to any audience. A free tier is available that lets you get started with minimal setup.

💡

Beginner Tip

Sign up at thenewsapi.com to receive a free API token and call the /v1/news/top endpoint to retrieve top stories immediately. Use the locale and language parameters to target specific regions or languages.

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

data[].uuid Unique identifier for the article
data[].title Headline of the news article
data[].url URL to the original article
data[].published_at ISO 8601 date and time the article was published
data[].source Domain name of the news source that published the article
meta.found Total number of articles matching the query

Implementation Example

const url = "https://www.thenewsapi.com/";
// 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

401 Unauthorized The api_token parameter is missing or invalid
Ensure you append api_token=YOUR_API_KEY to your query string using the token from your thenewsapi.com dashboard
402 Payment Required The requested feature or volume exceeds your current plan
Check which endpoints and features are available on the free tier and upgrade if needed
Empty data array No articles matched the filters provided (locale, category, etc.)
Relax your filters — remove the category or try a different locale to confirm results are being returned

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

Similar APIs

View All →