Search for news articles

Searches and retrieves the details of news articles published on a website.

This Wrk Action divides. For more information on divides please visit our article explaining Divides.

Common use cases

Data Management

Application

Press Releases

Inputs (what you have)

NAME	DESCRIPTION	TYPE	REQUIRED	EXAMPLE
Title	Search article headlines/title	Text	Yes	Wrk
Content	Search all article content for the provided text	Text	Yes	Wrk
Country	Search articles published in the selected country: us,gb,de,it,fr,nl,see,dk,fi,hu,no,pl,pt,ru,ua,ch,be,nz,mx,au	Predefined Choice List	Yes	Canada
State/province	Search only local news articles published in the selected state/province	Text	Yes	Quebec
City	Search only local news articles published in the selected city	Text	Yes	Montreal
Release date form	Search articles published after the specified date	Date & Time	Yes	2022-02-01T00:00:00
Release date to	Search articles published before the specified date	Date & Time	Yes	2022-02-01T00:00:0
News source domain	Search only for articles published at a specific domain	URL	Yes	`cnn.com`
Maximum. number of results	The number of articles to retrieve. Max 100 articles.	Integer	Yes	5

Note: the value of inputs can either be a set value in the configuration of the Wrk Action within the Wrkflow, or a variable from the Data library section. These variables in the Data library section are the outputs of previous Wrk Actions in the Wrkflow.

Outputs (what you get)

NAME	DESCRIPTION	TYPE	REQUIRED	EXAMPLE
Status	Status code	Integer	False	Active
Number of results	Number of results found	Integer	False	10
Domain	Source domain	URL	False	`https://article/e29`
Sentiment neutral	Neutral sentiment score	Number	False	5
Sentiment negative	Negative sentiment score	Number	False	5
Sentiment positive	Positive sentiment score	Number	False	5
Article link	URL of the article	URL	False	`https://ehoi2/artciles`
Claims	Article claims	Text	False	Tech
Title	Article title	Text	False	New technology
Medium	Article medium	Text	False	electronic
Added date	Article addition date	Text	False	2022-02-01T00:00:00
Content	Article content	Text	False	Technology
Country	Article country	Text	False	Canada
Published date	Article publication date	Text	False	2022-02-01T00:00:00
Reprint	Article reprint status	boolean	False	Active
Summary	Article summary	Text	False	This article contains information on the latest technology trends
Verdict	Article verdict	Text	False	True
Image link	Article image link	URL	False	img.1
Language	Article language	Text	False	English
Article id	Unique Article identifier	Text	False	Article1
Cluster id	Cluster identifier	Text	False	cluster A
Article description	Article description	Text	False	Technology trends
Refresh date	Last time the article was refreshed	Text	False	2022-02-01T00:00:00
Authors	Authors of the article	Text	False	John Smith

Outcomes

NAME	DESCRIPTION
Success	This status is selected in the event the Wrk Action returns at least one news article
No Result	This status is selected in the event of the following scenarios:- The Wrk Action finds no news articles with the given search criteria
Unsuccessful	This status is selected in the event of the following scenarios:- All scenarios covered in Application Product Design

Requirements

Configuration Tips

Within the Title and Content fields advanced search configurations can be added using the methods outlined below:

Boolean Operators

Boolean-style search operators provide a great way to filter the noise and narrow down your results. The following boolean operators are provided:

AND
OR
NOT
* Asterisk wildcard
? Question mark wildcard

By default, if no operator is provided with your query, the OR operator is used. For example:

Tesla Elon Musk - Returns articles that match Tesla or Elon or Musk
Tesla AND Elon AND Musk - Returns articles that have all three terms included, Tesla and Elon and Musk
Tesla AND NOT Elon - Returns articles that mention Tesla but do not mention Elon

Exact Matches

To search for an exact match, where the query must be present in the exact same form as your search, you need to use quotation marks. For example:

"Elon Musk" - Returns articles that contain the entire phrase "Elon Musk." If Elon is included, but Musk is not, or vice versa, the article will not be returned.
Tesla AND "Elon Musk" - Exact match searches can also be combined with boolean operators.
Tesla AND "Elon Musk" AND NOT "SpaceX Launch" - Returns articles that have both Tesla and the entire phrase "Elon Musk" in them but also filters out articles where "SpaceX Launch" is mentioned.

Case Insensitivity

The exact match search is case insensitive. For example, the "Elon Musk" query will also match documents that have the phrase in lowercase, like "elon musk."

Combining Operators

To combine multiple simple expressions into a more complex one, you can use parentheses:

(Google OR Amazon) AND NOT ("Jeff Bezos" OR Android) - Returns results that:
Have Google and/or Amazon mentioned
Do not contain any mention of "Jeff Bezos" or Android
(series OR raise OR round) AND (startup OR fund OR venture) - A more complex example of searching for a specific query that returns results about startup fundraising & venture capital.

Grouping & combining operators can be very useful when searching for things that could have many synonyms or iterations. The structure of the search, in this case, could be (synonym1 OR synonym2) AND (synonym3 OR synonym4).

Searching Word Variants

If you'd like to include variants of a common word within your search query, you can attach a wildcard character (an * asterisk) to a truncated portion of the root word. This is helpful for searching plurals, past tense, or other common variations that alter the end of a given word. For example:

withdr* - Returns results with any of the following words: withdraw, withdraws, withdrawal, withdrawn, withdrawing
immuni* - Returns results with any of the following words: immunity, immunizations, immunisations, immunizing, immunized

You can also use the wildcard asterisk to search variations within a word. These will match zero or more characters within the word. If the variations you seek must have only one character of variation within a word, use the question mark wildcard as shown below. For example:

ch*ter - Returns results for articles that contain words like: charter, character, or chapter
wom?n - Returns results for articles that contain either the word "woman" or "women"

The difference between the asterisk and the question mark wildcards is that the asterisk will return any variation regardless of the number of characters that produce the variant, whereas the question mark should be used to return a variant where only a single character may differ. Reminder - you cannot use an asterisk or question mark within quotations as quotations are reserved for exact match searches.