Google News engine for JoomGrabber

A special engine which could collect news from Google News based on keywords and many other criteria, this engine require API key from https://gnews.io/, GNews provide a free plan with 100 requests per day.

Update: Transition from Google News RSS Feed to GNews API

In the latest update of JoomGrabber, we have transitioned from using the Google News RSS feed to the GNews API for this engine. This change was made to address issues related to the extraction of original news links from the RSS feed.

Reason for the Change: The Google News RSS feed presented challenges due to the encryption of news links, which made it difficult to extract and use the original URLs. By switching to the GNews API, we can ensure more reliable access to news content and overcome the limitations posed by the encryption in the RSS feed.

For detailed information on using the GNews API with JoomGrabber, please refer to the GNews API documentation.

We appreciate your understanding and are confident that this update will enhance your experience with JoomGrabber.

Engine settings:

• API Key: required you need to register here to get the API key
• Type: 
  • Search by keywords: allows you to search for news articles through a combination of keywords.
  • Top Headlines: allows you to search for current trending articles, the articles that are selected to be returned are based on the Google News ranking. There are 9 categories available, the default category is "general".
• Keywords: This parameter allows you to specify your search keywords to find the news articles you are looking for. The keywords will be used to return the most relevant articles. It is possible to use logical operators with keywords.
  • Note: this parameter work only if type is Search by keywords
• Category: This parameter allows you to change the category for the request. The available categories are : general, world, nation, business, technology, entertainment, sports, science and health.
  
  • Note: this parameter work only if type is Top Headlines
• Limit Items: option to limit the number of fetched news.
• Language: option to set the language for fetched news.
• Country: This parameter allows you to specify the country where the news articles published, the contents of the articles are not necessarily related to the specified country.
• Search In: This parameter allows you to choose in which attributes the keywords are searched. The attributes that can be set are title, description and content. It is possible to combine several attributes.
• From: This parameter allows you to filter the articles that have a publication date greater than or equal to the specified value. 
• To: This parameter allows you to filter the articles that have a publication date smaller than or equal to the specified value.
• Sort By: This parameter allows you to choose with which type of sorting the articles should be returned.

The output fields of each fetched news:

• title: The main title of the article.
• description: The small paragraph under the title.
• content: All the content of the article.
  • The content is truncated.
  • Full content is only available if you have a paid subscription activated on your account.
• url: The URL of the article.
• image: The main image of the article.
• publishedAt: The date of publication of the article. The date is always in the UTC time zone.
• sourceName: The name of the source.
• sourceUrl: The homepage of the source.

Keywords Parameter Syntax

Things to know before you start :

1. It is not possible to use special characters without putting quotes around them.

e.g.

Phrase Search Operator

This operator allows you to make an exact search. Keywords surrounded by quotation marks are used to search for articles with the exact same keyword sequence. For example the query: "Apple iPhone" will return articles matching at least once this sequence of keywords.

Logical AND Operator

This operator allows you to make sure that several keywords are all used in the article search. By default the space character acts as an AND operator, it is possible to replace the space character by AND to obtain the same result. For example the query: Apple Microsoft is equivalent to Apple AND Microsoft

Logical OR Operator

This operator allows you to retrieve articles matching the keyword a or the keyword b. It is important to note that this operator has a higher precedence than the AND operator. For example the query: Apple OR Microsoft will return all articles matching the keyword Apple as well as all articles matching the keyword Microsoft

Due to the higher precedence of the operator OR the following query will not work as expected: Apple AND iPhone OR Microsoft. Normally, articles matching the keywords Apple and iPhone are returned first and then articles matching the keyword Microsoft are returned. Because of the precedence of the OR operator, in practice the query will return articles matching Apple AND iPhone or Apple AND Microsoft. To have a normal behavior, it is necessary to add brackets. The query Apple AND iPhone OR Microsoft will behave normally when it is in this form: (Apple AND iPhone) OR Microsoft

Logical NOT Operator

This operator allows you to remove from the results the articles corresponding to the specified keywords. To use it, you need to add NOT in front of each word or phrase surrounded by quotes. For example the query: Apple NOT iPhone will return all articles matching the keyword Apple but not the keyword iPhone

Examples of valid queries