API Authentication Guide

To use the API you need an API key. You can get a free one by simply signing up here.

Once you have your API key, you have to put it in the request URL for every request you make like so ?api-key=YOUR-API-KEY.

Attention: Only the first query parameter is prefixed with a ? (question mark), all subsequent ones will be prefixed with a & (ampersand). That is how URLs work and nothing related to our API. Here's a full example with two parameters api-key and text: https://api.worldnewsapi.com/search-news?api-key=YOUR-API-KEY&text=tesla.

Alternatively, you can put the API key in the request header as x-api-key.

Frequently Asked Questions

What authentication method does World News API use?

World News API uses API key authentication. You include your API key as a query parameter (?api-key=YOUR-API-KEY) or in the request header as x-api-key. No OAuth or token refresh is required.

Where do I get my API key?

You can get a free API key by signing up here. No credit card is required for the free tier, which includes 50 daily points.

Can I use the API key in the URL or in request headers?

Yes, both methods are supported. You can pass the API key as a query parameter (?api-key=YOUR-API-KEY) or in the request header using the x-api-key header. The header method is recommended for production applications as it keeps your key out of server logs and browser history.