Simple News API to search News and Blog Articles

GNews API is a simple REST API with which you can search for current and historic news articles published by over 60,000 sources. With this news API, you can also collect the current top headlines based on the Google News ranking.

A planet

Try GNews API

{
    "totalArticles": 0,
    "articles": []
}

* The search and results are in English only. To test other languages please refer to the documentation.

Start for free

Develop and test your applications for free, once your application is ready for production, activating your subscription only takes a few minutes.

Fast response & accurate

We store the news articles in our database to have the lowest possible response time and an outstandingly accurate search.

Easy-to-use

Our documentation is convenient to understand so you don't have to worry about integrating the API into your applications.

Worldwide Scale

Our database contains tens of millions of articles that we have collected from over 60,000 sources in 22 languages across 30 countries. You can filter articles by language, country, or both. It is important to note that the country filter is applied to the country of the source and not to the country that might be the subject of an article. In other words, filtering by country allows you to know the media coverage for a country according to your search.

Planet Earth

Response Performance

The response time of our news API is essential to us, we do our best to keep it as short as possible. The average response time of the API is between 100 and 200 ms.

News Articles Data

We use advanced extraction techniques to retrieve the different attributes that make up an article. Data quality is our number one concern, and we do everything we can to ensure that it is always excellent.

A rocket

Easy Integration

Get API results in JSON format via HTTP GET requests in any programming language and easily integrate them into your applications. To use the API it's as simple as this: you make a request, get the results, parse the JSON and the data is ready to be used. If you have difficulties integrating the API you can contact us through our chat or via email.

Live News Articles

We have created a system that runs continuously to retrieve any new article published on the sources we cover. As soon as a new article is found it is immediately added to our database and accessible through the API.

Historic Data

Articles stored in our database are never deleted, you can view the history of published articles stored over the years with our news API. You can, with the help of some filters, retrieve articles published in 2022, 2021, etc.

Advanced Request Options

Design complex queries in a logical way using search operators. Specify the context of your query with 10 easy-to-use optional parameters.

Search Operators

Perform advanced searches using search operators such as AND, OR and NOT to combine, separate and exclude keywords.

Consult the documentation for more information

Features for our subscribers

Retrieve full article content or use the paging feature with our subscriptions starting at 49.99 EUR per month (see pricing).

Pricing

Free for non-commercial projects, options if you're commercial

Free

€0

For non-commercial projects or for development and testing purposes only

100 requests per day

Up to 10 articles returned per request

Maximum of 1 request per second

Email support

Full article content and pagination

Essential

€49.99 per month

For production and published commercial projects

1000 requests per day

Up to 25 articles returned per request

Maximum of 4 requests per second

Email support

Full article content and pagination

Business

€99.99 per month

For larger commercial projects that require more resources

5000 requests per day

Up to 50 articles returned per request

Maximum of 6 requests per second

Email support

Full article content and pagination

Enterprise

€249.99 per month

For enterprise projects that require exceptional resources

25000 requests per day

Up to 100 articles returned per request

Maximum of 8 requests per second

Email support

Full article content and pagination

Need a personalized plan? You can contact us with the form below. For more information on custom plans, you can read the FAQ. A subscription is required for any commercial project, this is not the case during the development and testing phase.

FAQ

Below our FAQ, you will find a form to contact us if you do not find answers to your questions!

GNews API can not be used in commercial projects with a free subscription. The free subscription plan is made for non-commercial projects or for development and testing purposes.

When you have reached the daily request limit you cannot retrieve any more data and the API returns an error message (Error 403). Note that the request counter is reset to zero every day at 00:00 UTC.

If you need a custom plan, please contact us by email: contact[at]gnews.io or by using our contact form on our main page. Please note that no custom plan can be free and it is only possible to request higher features than the Essential plan.

When you change your subscription plan, your invoice is calculated so that you pay based on how many days you used the old subscription this month and how many days you have left with the new subscription. This means that you don't pay any additional fees, only what you use.

When a payment error occurs, Stripe will automatically try to make the payment 4 times over the following two weeks. If all attempts fail, your subscription will automatically be cancelled and downgraded. You will receive reminders per email during the two weeks.

Your subscription can be cancelled at any time at no additional cost in the "User Profile" section of the dashboard, simply check the "Cancel subscription at end of the period" box and click on the "Update Profile" button.

Yes, just send us an email using the form below and a key will be provided to you to test the API.

For the parameter "from" and "to" the date must exactly respect the format Y-m-dTH:i:sZ (where Y is the year on 4 digits, m the month on two digits from 1 to 12, d the day on two digits, H the hour on 2 digits from 0 to 23, i the minutes on 2 digits from 0 to 59 and s the seconds on two digits from 0 to 59). For example this date is valid 2022-01-01T12:30:45Z but this one is not valid 2022-01-01T12:30:45.1000Z

The full content of the articles is a feature that is reserved for subscribers. For the API to return the full content, you need to append this to the query string of the request: &expand=content

Unfortunately, it is not yet possible to filter the results with a list of sources.

The support email address is contact[at]gnews.io.

Contact us

Do you have a question?

Do not hesitate to contact us, we will answer you as soon as possible.