Description Usage Arguments Details Value Examples
get_everything returns articles from large and small news
sources and blogs. This includes news as well as other regular articles.
You can search for multiple sources, different language,
or use your own keywords. Articles can be sorted by the earliest date
publishedAt, relevancy, or popularity. To automatically
download all results, use get_everything_all().
Please check that the api_key is available. You can provide an explicit
definition of the key or use set_api_key().
Valid languages for language are provided in the dataset
terms_language.
1 2 3 4 | get_everything(query, sources = NULL, domains = NULL,
exclude_domains = NULL, from = NULL, to = NULL, language = NULL,
sort_by = "publishedAt", page = 1, page_size = 100,
api_key = Sys.getenv("NEWS_API_KEY"))
|
query |
Character string that contains the searchterm for the API's data base. API supports advanced search parameters, see 'details'. Passing a searchterm is compulsory. |
sources |
Character vector with with IDs of the news outlets you want to focus on (e.g., c("usa-today", "spiegel-online")). |
domains |
Character vector with domains that you want to restrict your search to (e.g. c("bbc.com", "nytimes.com")). |
exclude_domains |
Similar usage as with 'domains'. Will exclude these domains from your search. |
from |
Character string with start date of your search. Needs to conform
to one of the following lubridate order strings:
|
to |
Character string that marks the end date of your search. Needs to conform
to one of the following lubridate order strings:
|
language |
Specifies the language of the articles of your search. Must
be in ISO shortcut format (e.g., "de", "en"). See list of all
languages using |
sort_by |
Character string that specifies the sorting variable of your article results. Accepts three options: "publishedAt", "relevancy", "popularity". Default is "publishedAt". |
page |
Specifies the page number of your results that is returned. Must
be numeric. Default is first page. If you want to get all results
at once, use |
page_size |
The number of articles per page that are returned. Maximum is 100 (also default). |
api_key |
Character string with the API key you get from newsapi.org.
Passing it is compulsory. Alternatively, function can be
provided from the global environment (see |
Advanced search (see also www.newsapi.org): Surround entire phrases
with quotes (") for exact matches. Prepend words/phrases that must
appear with "+" symbol (e.g., +bitcoin). Prepend words that must not
appear with "-" symbol (e.g., -bitcoin). You can also use AND, OR,
NOT keywords (optionally grouped with parenthesis, e.g., 'crypto AND
(ethereum OR litecoin) NOT bitcoin)').
List with two dataframes:
1) Data frame with results_df
2) Data frame with meta_data
1 2 3 4 5 | ## Not run:
df <- get_everything(query = "stuttgart", language = "de")
df <- get_everything(query = "mannheim", from = "2019-01-02 12:00:00")
## End(Not run)
|
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.