Description Usage Arguments Details Value Author(s) References Examples
Retrieve the posts with a set of tags.
1 2 |
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. |
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.
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. |
Andrea Capozio
https://www.tumblr.com/docs/en/api/v2
1 2 3 4 5 6 7 8 | ## 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)
|
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.