万有引擎
搜索⌘K
中文
登录免费开始

社交内容 · 数据 API

Tumblr

Tumblr API

通过关键词、标签或博客短名读取 Tumblr 帖子与博客资料，保留 notes 互动汇总和内容出处，适合整理兴趣圈层的公开内容。 调用 POST /api/v1/social ；返回结构化 JSON，$1.39 / 千次；失败不计费。

免费开始 看文档

4

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Tumblr 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordpost_type默认 20 · 最多 200同步$1.39 / 千次id · url · text · post_type · author_username · author_name · author_url · note_count · posted_at · platform · tags
tagtaghashtag, post_type默认 20 · 最多 200同步$1.39 / 千次id · url · text · post_type · author_username · author_name · author_url · note_count · posted_at · platform · tags
user_postsusernamepost_type默认 20 · 最多 50同步$1.39 / 千次id · url · text · post_type · author_username · author_name · author_url · note_count · posted_at · platform · tags
profileusername——同步$1.39 / 千次username · display_name · bio · url · latest_post_at · platform

Tumblr 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

怎么调用 Tumblr 标签内容 API？

tag

使用 platform="tumblr"、action="tag" 调用“标签内容”能力；返回列表，默认 20 条、单次最多 200 条，主要包含 id、url、text、post_type、author_username、author_name 等 11 个字段。

Tumblr tag 的参数分别是什么意思？

tag必填
tag 的话题名，可带 #；返回公开标签内容。

官方说明标签页围绕已添加的特定标签组织帖子，搜索页则按检索词显示结果。此处只解释 tag 的对象，不承诺索引即时、结果全量或提供网页上的全部筛选按钮。官方来源：Tumblr：标签检索不是正文关键词检索来源核查：

hashtag可选
tag 的兼容写法，优先级低于 tag。
post_type可选
search / tag / user_posts 的单一帖子类型：any 不限、text 文本、photo 图片、video 视频、quote 引语、link 链接、audio 音频；不是数组，profile 不使用此过滤。
Tumblr 特有返回字段与含义（2）
post_type
内容类型（文字/图片/引用/链接/音频/视频）。Tumblr 按类型区分排版，同一博客里混排。
note_count
互动总数。Tumblr 把点赞与转发合并计为 notes，拆不开。

怎么调用 Tumblr 用户内容 API？

user_posts

使用 platform="tumblr"、action="user_posts" 调用“用户内容”能力；返回列表，默认 20 条、单次最多 50 条，主要包含 id、url、text、post_type、author_username、author_name 等 11 个字段。

Tumblr user_posts 的参数分别是什么意思？

username必填
博客短名或 name.tumblr.com 域名，不要在此字段传带 https:// 的完整链接；完整地址应放 url。profile 只整理公开博客资料，不保证粉丝数量。

官方说明 reblog 会让现有帖子出现在另一个博客上，也可附加内容；带新增内容的转博可进入普通搜索，但不进入标签搜索。本接口没有完整转博链，不能仅以当前博客身份推断原创作者。官方来源：Tumblr：博客中的 reblog 与原创来源来源核查：

post_type可选
search / tag / user_posts 的单一帖子类型：any 不限、text 文本、photo 图片、video 视频、quote 引语、link 链接、audio 音频；不是数组，profile 不使用此过滤。
Tumblr 特有返回字段与含义（2）
post_type
内容类型（文字/图片/引用/链接/音频/视频）。Tumblr 按类型区分排版，同一博客里混排。
note_count
互动总数。Tumblr 把点赞与转发合并计为 notes，拆不开。

怎么调用 Tumblr 主页或对象详情 API？

profile

使用 platform="tumblr"、action="profile" 调用“主页或对象详情”能力；返回单个对象，主要包含 username、display_name、bio、url、latest_post_at、platform。

Tumblr profile 的参数分别是什么意思？

username必填
博客短名或 name.tumblr.com 域名，不要在此字段传带 https:// 的完整链接；完整地址应放 url。profile 只整理公开博客资料，不保证粉丝数量。

官方说明一个账号可以有主博客及附属博客，附属博客也可由多人管理或设置密码。因此博客名称不等于独立个人身份，本页资料不提供账号关系识别或密码保护内容的访问权限。官方来源：Tumblr：主博客、附属博客与多人博客来源核查：

Tumblr 特有返回字段与含义（1）
latest_post_at
最近一次发布时间。
Tumblr search 调用流程一次 Tumblr search 调用的全过程：向 POST /api/v1/social 发送 platform="tumblr"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、text、post_type、author_username 等字段；返回列表，单次最多 200 条，计费 $1.39 / 千次，失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "tumblr"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表idurltextpost_typeauthor_username
一次 Tumblr search 调用的全过程：向 POST /api/v1/social 发送 platform="tumblr"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、text、post_type、author_username 等字段；返回列表，单次最多 200 条，计费 $1.39 / 千次，失败与空结果不计费。

Tumblr 原始字段名

EveryInfra 统一字段名

左边是 Tumblr 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

Tumblr 的独有字段名（当前目录）

全站 89 个平台的当前目录中，这 2 个字段名只在 Tumblr 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

  • note_count
  • latest_post_at

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields

id
该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url
该记录在原平台上的可访问链接。
text
正文内容，已去除 HTML 标签。长文可能被截断。
post_type
内容类型（文字/图片/引用/链接/音频/视频）。Tumblr 按类型区分排版，同一博客里混排。
author_username
作者用户名（@handle），通常可用于拼 URL。
author_name
作者昵称（显示名）。
author_url
作者在原平台的主页链接。
note_count
互动总数。Tumblr 把点赞与转发合并计为 notes，拆不开。
posted_at
发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
platform
数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
tags
标签数组。无标签时为空数组，不是 null。
username
用户名（@handle）。
display_name
显示名，可能与 username 不同。
bio
个人简介，账号自己填写的文本。可能含换行和 emoji。
latest_post_at
最近一次发布时间。

请求填写示例

这里检索公开内容；博客名称与标签模式分别按参数说明使用。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

tumblr_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"tumblr","action":"search","params":{"keyword":"film photography"}}'

记录字段预览（非真实响应）

仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "id": null,
  "url": null,
  "text": null,
  "post_type": null,
  "author_username": null,
  "author_name": null,
  "author_url": null,
  "note_count": null,
  "posted_at": null,
  "platform": null,
  "tags": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

搜索 Tumblr 帖子文字，并正确解读 notes

用 search 查主题讨论，不把关键词检索和标签页当成相同入口。

查看 search 的 keyword 参数 →
  • keyword 按 /search/ 路径进行公开帖子检索；返回 text 是整理后的文字，不是原始 HTML。Tumblr 网站搜索还可能展示博客和其他推荐，但本接口只提供帖子记录。
  • note_count 是 Tumblr 的 notes 汇总，涵盖点赞、转博与评论，不是独立点赞数或人数。本页没有把三者分别拆开的字段，也没有评论正文 action；不要从单个总数反推出互动构成。

按 Tumblr 标签寻找同一话题的公开帖子

用 tag 读取标签内容，而不是在帖子正文里搜索同名词。

查看 tag 的 tag 参数 →
  • tag 是标签名称，可带开头的 #；hashtag / keyword 是低优先级兼容输入，公开必填项仍是 tag。Tumblr 官方区分 search 与 tag pages，不能把标签结果当作所有提及该词的帖子。
  • id / url 用于定位条目，posted_at 保留发布时间。标签搜索不等于完整转博传播链，本接口也没有游标或传播图字段；列表不足不能据此认定该话题只有这些帖子。

整理指定 Tumblr 博客的帖子，而非认定全部原创

用 user_posts 查看博客内容，并按需要使用单一帖子类型过滤。

查看 user_posts 的 post_type 参数 →
  • username 填博客短名或 name.tumblr.com 域名，不填带 https:// 的完整链接；该目录当前未开放 url 作为此 action 的可选参数。post_type 可按文档使用 any、text、photo、video、quote、link 或 audio，不能传数组；其机器可校验值域尚待补齐，筛选效果未逐项真调。
  • Tumblr 转博会把已有帖子放到另一个博客，所以 author_username / author_url 对应博客线索，不足以证明它是所有内容的原创作者。本接口保留 text、post_type 和 note_count，没有完整转博链或图片、音视频文件字段。

核对 Tumblr 博客资料，不将博客等同于个人账号

用 profile 获取一个博客的轻量公开资料，不推算粉丝或账号关系。

查看 profile 的 username 参数 →
  • username 填博客短名或 name.tumblr.com；返回 username、display_name、bio 与 url。Tumblr 存在主博客、附属博客和多人博客，因此一个博客不是一个独立自然人的证明；当前字段也不判断博客类型或关联账号。
  • 资料从取得的首条帖子关联信息整理；没有可用帖子时资料可能缺失，不能直接判定博客不存在。latest_post_at 来自该条帖子的时间，未保证全博客最新；没有 follower_count，也不绕过密码保护。

Tumblr API 常见问题

Tumblr API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="tumblr"、action 和 params。以 search 为例，必填 keyword，可选 post_type。这里检索公开内容；博客名称与标签模式分别按参数说明使用。 Tumblr 共 4 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Tumblr API 怎么收费？

$1.39 / 千次，Tumblr 全部 4 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 719 次 Tumblr 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

Tumblr API 一次能返回多少条数据？

Tumblr 有 3 个列表接口，包括 search、tag、user_posts。其余 1 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

Tumblr API 返回哪些字段？

当前目录为 search 列出 id、url、text、post_type、author_username、author_name 等 11 个字段名。按全站当前目录统计，2 个字段名只在 Tumblr 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「搜索 Tumblr 帖子文字，并正确解读 notes」怎样接入 Tumblr API？

用 search 查主题讨论，不把关键词检索和标签页当成相同入口。 keyword 按 /search/ 路径进行公开帖子检索；返回 text 是整理后的文字，不是原始 HTML。Tumblr 网站搜索还可能展示博客和其他推荐，但本接口只提供帖子记录。 note_count 是 Tumblr 的 notes 汇总，涵盖点赞、转博与评论，不是独立点赞数或人数。本页没有把三者分别拆开的字段，也没有评论正文 action；不要从单个总数反推出互动构成。

「按 Tumblr 标签寻找同一话题的公开帖子」怎样接入 Tumblr API？

用 tag 读取标签内容，而不是在帖子正文里搜索同名词。 tag 是标签名称，可带开头的 #；hashtag / keyword 是低优先级兼容输入，公开必填项仍是 tag。Tumblr 官方区分 search 与 tag pages，不能把标签结果当作所有提及该词的帖子。 id / url 用于定位条目，posted_at 保留发布时间。标签搜索不等于完整转博传播链，本接口也没有游标或传播图字段；列表不足不能据此认定该话题只有这些帖子。

「整理指定 Tumblr 博客的帖子，而非认定全部原创」怎样接入 Tumblr API？

用 user_posts 查看博客内容，并按需要使用单一帖子类型过滤。 username 填博客短名或 name.tumblr.com 域名，不填带 https:// 的完整链接；该目录当前未开放 url 作为此 action 的可选参数。post_type 可按文档使用 any、text、photo、video、quote、link 或 audio，不能传数组；其机器可校验值域尚待补齐，筛选效果未逐项真调。 Tumblr 转博会把已有帖子放到另一个博客，所以 author_username / author_url 对应博客线索，不足以证明它是所有内容的原创作者。本接口保留 text、post_type 和 note_count，没有完整转博链或图片、音视频文件字段。

「核对 Tumblr 博客资料，不将博客等同于个人账号」怎样接入 Tumblr API？

用 profile 获取一个博客的轻量公开资料，不推算粉丝或账号关系。 username 填博客短名或 name.tumblr.com；返回 username、display_name、bio 与 url。Tumblr 存在主博客、附属博客和多人博客，因此一个博客不是一个独立自然人的证明；当前字段也不判断博客类型或关联账号。 资料从取得的首条帖子关联信息整理；没有可用帖子时资料可能缺失，不能直接判定博客不存在。latest_post_at 来自该条帖子的时间，未保证全博客最新；没有 follower_count，也不绕过密码保护。

可以先免费试用 Tumblr API 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 Tumblr 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 4 个能力。无需信用卡。

更多社交内容 API

Behance APIB站 APIBluesky APIDailymotion APIDeviantArt APIDiscord API豆瓣 API抖音 API全部 89 平台 ↗

开始调用 Tumblr API

加微信领 $1 免费额度，先选一个 Tumblr 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始