NewsData API

Beginner's Pick News / API Key Intermediate HTTPS

82 A

Metadata Score Metadata estimate · not endpoint-tested

Visit Official Site Compare Alternatives

Overview

NewsData.io provides live and breaking news headlines sourced from thousands of reputable news outlets around the world. You can filter articles by keyword, country, language, or news category such as politics, sports, or technology. It is a great starting point for developers building news dashboards or content aggregation tools.

Beginner Tip

Use the apikey query parameter and start with the /news endpoint to pull the latest articles — add the q parameter to search by keyword. The free plan allows up to 200 requests per day and returns up to 10 results per call.

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

status "success" when the request is valid, "error" on failure

totalResults Number of articles returned in this response

results[].title Headline of the news article

results[].link URL to the original article on the publisher site

results[].pubDate Publication date and time of the article

results[].source_id Unique identifier for the news source that published the article

Implementation Example

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

Request

const url = "https://newsdata.io/docs";
// 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 Authentication Failed Your API key is missing or incorrect

✓ Check that you are passing apikey=YOUR_API_KEY in the query string exactly as shown in your NewsData.io dashboard

422 Unprocessable Entity An unsupported country code or language code was supplied

✓ Refer to the NewsData.io docs for the list of accepted country and language codes (e.g., "en", "us")

429 Too Many Requests You have hit the daily request limit for your current plan

✓ Cache results and wait for the daily counter to reset at midnight UTC, or upgrade to a paid plan

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? →