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 |
|
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 |
|
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 |
|
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
N/A
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:
ANDORNOT*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 MuskTesla AND Elon AND Musk- Returns articles that have all three terms included, Tesla and Elon and MuskTesla 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, withdrawingimmuni*- 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 chapterwom?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.