Documentation /api/v3
Overview, how to use and features.
The Unofficial Google News API give you a way to find Google News articles from key words. Additionally, you can get the top articles and get articles from topic like sports, health, business and more.
Our API allows you to receive up to 100 articles per request (max item number depends on your plan). Each article contains a title, a description, the article link, the website, the source, the date and the article image.
Response preview
loading...Endpoints
Search
https://gnews.io/api/v3/searchThis endpoint allows you to search google news from keywords.
Read documentationTop News
https://gnews.io/api/v3/top-newsThis endpoint allows you to get the top google news.
Read documentationTopic
https://gnews.io/api/v3/topics/{topic}This endpoint allows you to get google news from a topic, like business, health, sports, etc.. Full list in the topic documentation.
Read documentationAuthentication
To be authenticate by the API you must give your API token. You can find your token in this page Dashboard. The API token is passed as GET parameter in the url. For example https://gnews.io/api/v3/search?token=API-Token
Response
loading...| Property | Description |
|---|---|
| timestamp | The end timestamp of the query execution |
| articles[i].title | Article title |
| articles[i].description | Short description of the article |
| articles[i].url | Article url |
| articles[i].image | Article image (may sometimes missing because the website doesn't give the permission on their images) |
| articles[i].publishedAt | Article published date |
| articles[i].source | Informations about the source of the article |
| articles[i].source.name | Name of the media or the source |
| articles[i].source.url | Url of the source |