EveryData platform API

Tumblr API

Q: What can I retrieve with the Tumblr API?

Set `platform` to `tumblr`. The current catalog lists search, tag, posts by user, and profiles. These action names identify different Tumblr objects or views; they are not interchangeable search modes.

Q: Which input starts a Tumblr `search` request?

Public post search term for `search`. The compatibility keyword input for `tag` actually queries by tag and cannot be treated as an identical search entry point. Send it as `keyword` inside `params`.

Q: Which fields can Tumblr `search` return?

Its declared schema includes `text`, `post_type`, `author_username`, and `author_name`. A declared field can still be absent from an individual source record, and every other action has its own field list.

Tumblr offers the 4 declared views used here for Tumblr posts discovered by query, tag, or blog plus public blog profiles, and `search`, `tag`, `user_posts` must each be read according to its own contract.

Tumblr keeps `search` (matching public results) apart from `tag` (a selected tag feed); `keyword` and `tag` apply only inside those contracts.

Start for free View the public catalog

Endpoint: POST /api/v1/social
Capabilities: 4
Per 1,000: $1.389

Available capabilities

Compare the Tumblr actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.

Action	Required	Optional	Delivery	Limit	Per 1,000	Response fields
`search` Search Search public results on Tumblr. Accepts these parameters: `keyword` and `post_type`. Returns these fields: `author_url`, `text`, `author_username`, and `author_name`.	keyword	post_type	Sync delivery	Catalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.	$1.39 per 1,000 requests	id · url · text · post_type · author_username · author_name · author_url · note_count · posted_at · platform
`tag` Tag Retrieve a public tag feed from Tumblr. Accepts these parameters: `tag`, `keyword`, `post_type`, and `hashtag`. Returns these fields: `author_name`, `author_username`, `post_type`, and `text`.	tag	hashtag, keyword, post_type	Sync delivery	Catalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.	$1.39 per 1,000 requests	id · url · text · post_type · author_username · author_name · author_url · note_count · posted_at · platform
`user_posts` Posts by user Retrieve public posts from Tumblr. Accepts these parameters: `post_type` and `username`. Returns these fields: `author_username`, `post_type`, `note_count`, and `text`.	username	post_type	Sync delivery	Catalog values: defaultLimit=20, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.	$1.39 per 1,000 requests	id · url · text · post_type · author_username · author_name · author_url · note_count · posted_at · platform
`profile` Profiles Retrieve public profile details from Tumblr. Accepts these parameters: `username`. Returns these fields: `bio`, `display_name`, `latest_post_at`, and `username`.	username	—	Sync delivery	—	$1.39 per 1,000 requests	username · display_name · bio · url · latest_post_at · platform

What does each Tumblr action accept?

Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.

Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.

What do the Tumblr `search` parameters mean?

Search public results on Tumblr. Accepts these parameters: keyword and post_type. Returns these fields: author_url, text, author_username, and author_name.

keywordRequired: Public post search term for search. The compatibility keyword input for tag actually queries by tag and cannot be treated as an identical search entry point.
Tumblr: Differences Between Keyword Search and Tag PagesOfficial documentation separates search pages from tag pages: search pages discover content by words, whereas tag pages aggregate posts containing a specific tag. Blog recommendations, sorting options, and search operators on Tumblr web pages are not automatically supported or verified parameters for this endpoint.Checked 2026-09-04
post_typeOptional: Single post type for search, tag, or user_posts: any for unrestricted, text, photo, video, quote, link, or audio. This is not an array, and profile does not use this filter.
Tumblr: Notes Across Post Types Are Not Separate Like CountsOfficial Tumblr documentation defines notes as the combined likes, reblogs, and comments received by a post. Changing the post type does not automatically split note_count into three separate metrics in this endpoint, nor can the total interaction count be interpreted as unique user counts.Checked 2026-09-04

What do the Tumblr `tag` parameters mean?

Retrieve a public tag feed from Tumblr. Accepts these parameters: tag, keyword, post_type, and hashtag. Returns these fields: author_name, author_username, post_type, and text.

tagRequired: Topic name for tag, optionally prefixed with #. Returns public tag content.
Tumblr: Tag Search vs. Full-Text Keyword SearchOfficial documentation explains that tag pages organize posts around a specific added tag, whereas search pages display results based on search queries. This entry clarifies the scope of tags and does not guarantee real-time indexing, complete results, or all filtering options available on the web interface.Checked 2026-09-04
hashtagOptional: Compatibility variant for tag, with lower precedence than tag.
keywordOptional: Public post search term for search. The compatibility keyword input for tag actually queries by tag and cannot be treated as an identical search entry point.
post_typeOptional: Single post type for search, tag, or user_posts: any for unrestricted, text, photo, video, quote, link, or audio. This is not an array, and profile does not use this filter.

What do the Tumblr `user_posts` parameters mean?

Retrieve public posts from Tumblr. Accepts these parameters: post_type and username. Returns these fields: author_username, post_type, note_count, and text.

usernameRequired: Blog short name or name.tumblr.com domain. Do not pass a full link containing https:// in this field; complete addresses belong in url. profile queries aggregate public blog data only.
Tumblr: Reblogs and Original Attribution in BlogsOfficial documentation notes that reblogs place an existing post on another blog and allow added content; reblogs with added content can appear in general search, but not tag search. This endpoint does not provide a complete reblog chain and cannot infer the original author based solely on the current blog identity.Checked 2026-09-04
post_typeOptional: Single post type for search, tag, or user_posts: any for unrestricted, text, photo, video, quote, link, or audio. This is not an array, and profile does not use this filter.

What do the Tumblr `profile` parameters mean?

Retrieve public profile details from Tumblr. Accepts these parameters: username. Returns these fields: bio, display_name, latest_post_at, and username.

usernameRequired: Blog short name or name.tumblr.com domain. Do not pass a full link containing https:// in this field; complete addresses belong in url. profile queries aggregate public blog data only.
Tumblr: Primary Blogs, Secondary Blogs, and Group BlogsOfficial documentation states that an account can have a primary blog as well as secondary blogs, which can be password-protected or managed by multiple users. Consequently, a blog name does not equal a unique personal identity, and the data on this page does not provide access permissions to password-protected content or account relationship identification.Checked 2026-09-04

How to use the Tumblr API

01Read the public catalog and choose a platform action.
02Send the platform, action, and required parameters to POST /api/v1/social.
03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
04Store the structured response fields needed by your application.

tumblr_search.sh

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"tumblr","action":"search","params":{"keyword":"<keyword>"}}'

Tumblr API questions

What can I retrieve with the Tumblr API?

Set platform to tumblr. The current catalog lists search, tag, posts by user, and profiles. These action names identify different Tumblr objects or views; they are not interchangeable search modes.

Which input starts a Tumblr `search` request?

Public post search term for search. The compatibility keyword input for tag actually queries by tag and cannot be treated as an identical search entry point. Send it as keyword inside params.

Which fields can Tumblr `search` return?

Its declared schema includes text, post_type, author_username, and author_name. A declared field can still be absent from an individual source record, and every other action has its own field list.

Does every Tumblr action return immediately?

No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.

Behance API Bilibili API Bluesky API Dailymotion API DeviantArt API Discord API Douban API Douyin API View the public catalog →