filter_posts: Retrieve structured posts data from news articles, blog posts...

In hrbrmstr/webhose: Tools to Work with the 'webhose.io' 'API'

Description

Retrieve structured posts data from news articles, blog posts and online discussions

Usage

filter_posts(query, sort = "relevancy", ts = (Sys.time() - (3 * 24 * 60 *
  60)), order = "desc", size = 100, accuracy_confidence = NULL,
  highlight = FALSE, from = 0, quiet = !interactive(),
  token = Sys.getenv("WEBHOSE_TOKEN"), ...)

Arguments

query	A string query containing the filters that define which posts will be returned.
sort	By default the results are sorted by relevancy. Acceptable values are "relevancy", "social.facebook.likes", "social.facebook.shares", "social.facebook.comments", "social.gplus.shares", "social.pinterest.shares", "social.linkedin.shares", "social.stumbledupon.shares", "social.vk.shares", "replies_count", "participants_count", "spam_score", "performance_score", "published", "thread.published", "domain_rank", "ord_in_thread", "rating".
ts	A timestamp to start the search from. If a POSIXct is passed in, it will be converted to the necessary value in milliseconds. Default is previous 3 days.
order	asc (ascending) or desc (descending, default) sort order for results
size	Total number of posts returned per request, ranges between 1:100 (default is 100).
accuracy_confidence	NULL or high. If high, return only posts with high extraction accuracy, but removes about 30 lower confidence).
highlight	FALSE or TRUE. Return the fragments in the post that matched the textual boolean query. The matched keywords will be surrounded by <em/> tags. Default: FALSE
from	Paging parameter (starting record number). Default is 0.
quiet	By default, calls in interactive sessions will return updates during fetching. Use TRUE to suppress these messages.
token	Your private access token. You get a unique access token when you sign up. Store it in an environment variable WEBHOSE_TOKEN (usually in ~/.Renviron) or provide it directly.
...	other parameters passed on to httr::GET()

Value

a list with these fields:

• totalResults: The total number of posts matching your query (numeric)

• moreResultsAvailable: How many more results are available (numeric)

• next: A URL to get the next batch of posts matching your query. (character)

• requestsLeft: How many more requests are available in your current subscription plan. (numeric)

References

webhose API

Examples

## Not run: 
res <- filter_posts("(China AND United) language:english site_type:news site:bloomberg.com",
                            ts = 1213456)

## End(Not run)

hrbrmstr/webhose documentation built on May 30, 2019, 6:56 p.m.