TheNews API

Beginner's Pick News / API Key Intermediate HTTPS CORS

77 B

Metadata Score Metadata estimate · not endpoint-tested

Visit Official Site Compare Alternatives

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

The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.

article title and content

publication source

published date

article URL

image URL

Example Response

Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.

JSON Response · Illustrative

{
  "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

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request

const url = "https://api.thenewsapi.com/v1/news/top?api_token=YOUR_API_KEY&locale=us&language=en";
// 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

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

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

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

How is this scored? →