How to Make Your First Request

Use Your API Key

Your API key is your unique identifier. It must be passed directly in the request URL as a query parameter.

Choose a Tool

You can use HTTP REST clients (such as Postman) or Curl to retrieve data in JSON format. We’ve also launched an official Postman collection to help you get started instantly - simply import it and start testing requests without writing any code.

To get started quickly with our official Postman collection, click below

Run in Postman

If you prefer a simpler, no-code approach, you can use our Query Builder to create your first request visually, apply filters, and generate a ready-to-use API URL in seconds.

Here are few examples of a request to retrieve news articles:

Fetch the latest headlines by specifying a search keyword in the q parameter.

https://newsdata.io/api/1/latest?apikey=YOUR_API_KEY&q=pizza

This request will search for the latest news articles that contain the keyword "pizza". The apikey parameter is used to authenticate your account and is required in all requests

You can also use additional parameters to refine your search, such as specifying a language, category, domain name etc.

Fetch Historical News

Use the archive endpoint to retrieve news from specific dates using language and date filters.

https://newsdata.io/api/1/archive?apikey=YOUR_API_KEY&q=example&language=en&from_date=2026-10-14&to_date=2026-10-21

This request will search for English language news articles published between October 14, 2026 and October 21, 2026 that contain the keyword "pizza".

Once you've made a request, you will receive a response in JSON format containing the news articles that match your search criteria.