News API - Get top headlines by country

Important: This connector and its actions have been removed from Nintex Workflow and can now be found in Nintex Gallery.

Use the News API - Get top headlines by country action A tool for building the processes, logic, and direction within workflows. Actions are the steps the workflow performs to complete a process. to retrieve the top news headline articles for the country selected in the action.

Attribution Unless otherwise authorised, you shall agree to display an attribution to News API alongside any implementation or display of the News API Data to indicate that News API technology is being used. The attribution should preferrably be a hyperlink to https://newsapi.org with the text "Powered by News API".

For more information about the News API connector, go to News API.

Before you begin: 

Jump to:

Configure the News API - Get top headlines by country action

  1. Add the action to the workflow and open the action configuration panel. For more information, see Add an action to the workflow.

  2. Select a Connection. If you do not have a connection, see Add a connection.
  1. Select the Country to search for headline news in.
  2. Add news category, search query key words, and paging options.
  3. Create or select a variable for the output.

News API - Get top headlines by country action fields and settings

Section Field Description Variable types

(unlabeled)

Connection Credentials and other settings that enables workflows to communicate with external systems, services, or applications. It's required to pass data between the workflow and the indicated service, which could be a cloud service, business application, or content store.

The News API connection used to retrieve the headline news articles.

To refresh the available connections, click .

 (n/a)

 

 Country

The country to search in for top headline news articles.

If you use a variable, use the 2-letter ISO 3166-1 code of the country you want to get headlines for. For a list of the supported country codes see News API - Top headlines.

Text, Decimal, Integer, Boolean, DateTime, Collection
  Category News type category to search in for the news article headlines Text, Decimal, Integer, Boolean, DateTime, Collection
  Search query Key words to search for within the headlines. Text, Decimal, Integer, Boolean, DateTime, Collection
Paging Items per page The number of articles to retrieve per page. Used with Page for paging. Integer
  Page The page number of articles to retrieve. Used with Items per page for paging. Integer
Output News results

Stores the result of the action as an object with the following variables:

  • Status: (Text) If the request was successful or not. Options: ok, or error.

  • Total results: (Integer) The total number of results available for your request.

  • Articles: (Collection) The results of the request.

    • Source: (Object) The identifier id and a display name for the source this article came from.

      • ID: (Text) The unique identifier of the news source.

      • Name: (Text) The display name of the news source.

    • Author: (Text) The author of the article.

    • Title: (Text) The headline or title of the article.

    • Description: (Text) A description or snippet from the article.

    • URL: (Text) The direct URL to the article.

    • Image URL: (Text) The URL to a relevant image for the article.

    • Published at: (DateTime) The date and time that the article was published, in UTC (+000).

    • Content: (Text) The unformatted content of the article, where available. This is truncated to 200 chars.

 Object