followers: Retrieve a Blog's Followers

Description Usage Arguments Details Value Author(s) References Examples

View source: R/followers.R

Description

Retrieve the followers of the user's blog.

Usage

1
2
followers(base_hostname = NA, limit = 20, offset = 0, token = NA, 
			consumer_key = NA, consumer_secret = NA)

Arguments

base_hostname

The standard or custom blog hostname. See Details.

limit

The number of results to return: 1-20, inclusive.

offset

Result to start at. 0 is the first follower.

token

Represents the complete set of data needed for OAuth access: an app, an endpoint, cached credentials and parameters. See Details.

consumer_key

The consumer key provided by your application.

consumer_secret

The consumer secret provided by your application.

Details

Each blog has a unique hostname. The hostname can be standard or custom. Standard hostname: the blog short name + .tumblr.com. Custom hostname: Anything at all, as determined by a DNS CNAME entry. The API uses three different levels of authentication, depending on the method. None: No authentication. Anybody can query the method. API key: Requires an API key. Use your OAuth Consumer Key as your api_key. OAuth: Requires a signed request that meets the OAuth 1.0a Protocol.

The API supports the OAuth 1.0a Protocol, accepting parameters via the Authorization header, with the HMAC-SHA1 signature method only.

Value

A list object with the following fields:

total_users

A number. The number of users currently following the blog.

users

An array. Each item is a follower, containing these fields:

name

A string. The user's name on tumblr.

following

A boolean. Whether the caller is following the user.

url

A string. The URL of the user's primary blog.

updated

A number. The time of the user's most recent post, in seconds since the epoch.

Author(s)

Andrea Capozio

References

https://www.tumblr.com/docs/en/api/v2

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
## Not run: 	
## An example of an authenticated request using the httr package,
## where consumer_key, consumer_secret, appname are fictitious.
## You can obtain your own at https://www.tumblr.com/oauth/apps
consumer_key <-'key'
consumer_secret <- 'secret'
appname <- Tumblr_App
tokenURL <- 'https://www.tumblr.com/oauth/request_token'
accessTokenURL <- 'https://www.tumblr.com/oauth/acces_token'
authorizeURL <- 'https://www.tumblr.com/oauth/authorize'

app <- oauth_app(appname, consumer_key, consumer_secret)	
endpoint <- oauth_endpoint(tokenURL, authorizeURL, accessTokenURL)
token <- oauth1.0_token(endpoint, app)
sig <- sign_oauth1.0(app, 
token = token$credentials$oauth_token, 
token_secret = token$credentials$oauth_token_secret)

## you must specify a real blog for base_hostname
base_hostname <- "blogname.tumblr.com"

followers(base_hostname = base_hostname, limit = 20, offset = 0, token = token,
consumer_key = consumer_key, consumer_secret = consumer_secret)

## End(Not run)

tumblR documentation built on March 18, 2020, 5:09 p.m.

Related to followers in tumblR...