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
## 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 <- 'http://www.tumblr.com/oauth/request_token'
accessTokenURL <- 'http://www.tumblr.com/oauth/access_token'
authorizeURL <- 'http://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)