tumblR (version 1.2)

tagged: Get Posts with Tag.

Description

Retrieve the posts with a set of tags.

Usage

tagged(api_key = NA, tag = NA, before = as.integer(Sys.time()), 
limit = 20, filter = "HTML")

Arguments

api_key

Your OAuth Consumer Key. See Details.

tag

The tag on the posts you'd like to retrieve.

before

The timestamp of when you'd like to see posts before. Current timestamp is the default.

limit

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

filter

Specifies the post format to return, other than HTML: text - plain text, no HTML; raw - as entered by the user(no post-processing); if the user writes in Markdown, the Markdown will be returned rather than HTML.

Value

A list object with the following fields:

blog_name

A string. The short name used to uniquely identify a blog.

id

A number. The unique ID of the post.

post_url

A string. The location of the post.

type

A string. The type of post.

timestamp

A number. The time of the post, in seconds since the epoch.

date

A string. The GMT date and time of the post, as a string.

format

A string. The post format: html or markdown.

reblog_key

A string. The key used to reblog this post.

tags

An array (string). Tags applied to the post.

bookmarklet

A boolean. Indicates whether the post was created via the Tumblr bookmarklet. Exists only if true.

mobile

A boolean. Indicates whether the post was created via mobile/email publishing. Exists only if true.

source_url

A string. The URL for the source of the content for quotes, reblogs, etc.. Exists only if there is a content source.

source_title

A string. The title of the source site. Exists only if there is a content source.

liked

A boolean. Indicates if a user has already liked a post or not.Exists only if the request is fully authenticated with OAuth.

state

A string. Indicates the current state of the post. States are: published, queued, draft and private.

total_posts

A number. The total number of post available for this request, useful for paginating through results.

Details

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.

References

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

Examples

# NOT RUN {
## An example of an authenticated request,
## where api_key is fictitious.
## You can obtain your own at https://www.tumblr.com/oauth/apps	
api_key <- "key"

tag <- "api"

tagged(api_key = api_key, tag = tag)
# }