社交内容 · 数据 API

微博

微博 API

按关键词收集微博文本,按数字 UID 核对账号,并读取单帖评论与热搜词条;区分转发、点赞计数和榜单热度,供记录公开讨论。 调用 POST /api/v1/social ;返回结构化 JSON,$0.56 / 千次;失败不计费。

4

个能力

$0.56 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

微博 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeyword—默认 20 · 最多 50同步$0.56 / 千次id · url · text · posted_at · device · repost_count · comment_count · like_count · is_repost · author_id · author_name · author_bio · author_follower_count · author_following_count · author_verified · author_verified_reason · author_avatar_url · image_urls · video_url · platform
profileuser_id——同步$0.56 / 千次user_id · display_name · url · bio · gender · follower_count · following_count · post_count · is_verified · verified_reason · avatar_url · cover_image_url · company · created_at · platform
commentsurl—默认 20 · 最多 50同步$0.56 / 千次id · text · like_count · author_id · author_name · author_avatar_url · post_id · post_url · posted_at · platform
trending——默认 20 · 最多 200同步$0.56 / 千次rank · title · category · hot_value · label · is_hot · is_new · url · platform

微博 每个接口分别做什么

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

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

怎么调用 微博 主页或对象详情 API?

profile

使用 platform="weibo"、action="profile" 调用“主页或对象详情”能力;返回单个对象,主要包含 user_id、display_name、url、bio、gender、follower_count 等 15 个字段。

微博 profile 的参数分别是什么意思?

user_id必填
profile 的微博数字 UID,也可传含 /u/数字UID 的主页链接;不要用昵称替代,profile 不提供该用户全部发帖。

微博官方将 uid / screen_name 区分为用户 ID / 昵称,friends_count 是关注数,followers_count 是粉丝数。官方接口的昵称查询选项不等于本页 user_id 支持昵称解析;字段是否返回仍以 EveryInfra 契约与实际结果为准。官方来源:微博:UID、昵称与关注数量的定义来源核查:

微博 特有返回字段与含义(4)
verified_reason
认证说明。
company
公司。
gender
性别。
cover_image_url
封面图。

怎么调用 微博 评论 API?

comments

使用 platform="weibo"、action="comments" 调用“评论”能力;返回列表,默认 20 条、单次最多 50 条,主要包含 id、text、like_count、author_id、author_name、author_avatar_url 等 10 个字段。

微博 comments 的参数分别是什么意思?

url必填
comments 建议使用 /detail/纯数字帖子ID 的链接,或在 url 中直接填数字帖子 ID。当前解析只取最后一段数字,含字母的微博短码 URL 可能被误解析,勿直接依赖该格式。

微博历史开发文档将 MID 与 ID 分开,并明确含字母的 MID 可采用 base62 编码。这里只引用标识区别,不保证该历史接口仍可调用;本页 comments 没有自动转换能力,优先使用数字帖子 ID 链接。官方来源:微博:base62 MID 与数字 ID 的转换说明来源核查:

微博 特有返回字段与含义(3)
author_avatar_url
作者头像。
post_id
微博 ID。
post_url
微博链接。
微博 search 调用流程一次 微博 search 调用的全过程:向 POST /api/v1/social 发送 platform="weibo"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、text、posted_at、device 等字段;返回列表,单次最多 50 条,计费 $0.56 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "weibo"action: "search"keywordEveryInfra$0.56 / 千次2 · 响应 · 列表idurltextposted_atdevice
一次 微博 search 调用的全过程:向 POST /api/v1/social 发送 platform="weibo"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、text、posted_at、device 等字段;返回列表,单次最多 50 条,计费 $0.56 / 千次,失败与空结果不计费。

微博 原始字段名

EveryInfra 统一字段名

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

微博 的独有字段名(当前目录)

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

  • device
  • author_following_count
  • author_verified_reason
  • verified_reason

返回字段含义

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

id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
url
该记录在原平台上的可访问链接。
text
正文内容,已去除 HTML 标签。长文可能被截断。
posted_at
发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
device
发布设备(如「iPhone客户端」)。
repost_count
转发数(区别于引用转发)。null 表示不公开。
comment_count
评论数。null 表示不公开,不等于 0。
like_count
点赞数。null 表示该平台或该接口不公开此数据,不等于 0。
is_repost
是否为转发。
author_id
作者在原平台的唯一 ID。
author_name
作者昵称(显示名)。
author_bio
作者简介。
author_follower_count
作者粉丝数。null 表示不公开。
author_following_count
作者关注数。
author_verified
作者是否加 V。
author_verified_reason
认证说明(如「XX公司CEO」),判断大V身份靠它。
author_avatar_url
作者头像。
image_urls
图片列表。
video_url
视频链接。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
user_id
用户在原平台的唯一 ID。
display_name
显示名,可能与 username 不同。
bio
个人简介,账号自己填写的文本。可能含换行和 emoji。
gender
性别。
follower_count
粉丝数。null 表示不公开,不等于 0。
following_count
关注数。null 表示不公开,不等于 0。
post_count
发布内容总数。null 表示不公开,不等于 0。
is_verified
是否为平台认证账号(蓝V等)。null 表示无法判定。
verified_reason
认证说明。
avatar_url
头像图片链接。部分平台给的是带尺寸参数的 CDN 链接,可能有时效。
cover_image_url
封面图。
company
公司。
created_at
创建时间,格式同 posted_at。
post_id
微博 ID。
post_url
微博链接。
rank
热搜排名。
title
标题。平台无标题概念时(如纯文本帖)为 null。
category
分类名称,取值为原平台的分类体系,未做跨平台归一。
hot_value
热搜热度值。微博自有指标,只在榜单内可比。
label
热搜标签(爆/热/新)。
is_hot
是否为热门。
is_new
是否为新上榜。

请求填写示例

这里使用微博内容搜索词;单条详情的数字 ID 与字母短码不能直接混用。

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

weibo_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"weibo","action":"search","params":{"keyword":"城市骑行"}}'

记录字段预览(非真实响应)

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

fields.preview.json
{
  "id": null,
  "url": null,
  "text": null,
  "posted_at": null,
  "device": null,
  "repost_count": null,
  "comment_count": null,
  "like_count": null,
  "is_repost": null,
  "author_id": null,
  "author_name": null,
  "author_bio": null,
  "author_follower_count": null,
  "author_following_count": null,
  "author_verified": null,
  "author_verified_reason": null,
  "author_avatar_url": null,
  "image_urls": null,
  "video_url": null,
  "platform": null
}

常见用例

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

按关键词检索公开微博并区分转发

用 search 收集帖子文本和互动快照,由调用方持续留存对比。

查看 search 的 keyword 参数 →
  • keyword 搜公开帖子;id / url 定位微博,is_repost 区分转发标记,repost_count、comment_count、like_count 分别是转发、评论和点赞数量。
  • device 是公开的发布客户端信息,不是设备指纹;作者粉丝信息可能缺失,需另查 profile,不能将缺失值当作零粉丝或据搜索样本推断全网声量。

用微博数字 UID 核对账号档案

用 profile 查看账号资料,不把用户昵称或帖子 ID 当成 UID。

查看 profile 的 user_id 参数 →
  • user_id 填数字 UID 或含 /u/数字UID 的主页链接;display_name 是昵称,following_count 是关注数,follower_count 是粉丝数。
  • post_count 是发帖数量,不是返回了全部帖子;created_at 是账号注册时间,verified_reason 是平台认证说明,不是 EveryInfra 的资质审核。

用数字帖子 ID 读取微博评论

用 comments 对准一条微博,避免含字母的短码被当成数字 ID。

查看 comments 的 url 参数 →
  • url 优先填 /detail/纯数字帖子ID 的链接,也可在该字段填数字帖子 ID;当前只提取最后一段数字,不会自动将 base62 短码转换成帖子 ID。
  • id 是评论 ID,post_id 是被评论的微博 ID;text、author_name、like_count 与 posted_at 描述评论,不包含完整回复树,也不是发评论接口。

读取微博热搜条目而不是关键词搜索结果

用 trending 保存榜单快照,观察榜上话题及位置变化。

查看 trending 接口说明 →
  • trending 无需 keyword 或 user_id;rank 是返回的榜位,title 是热搜词,hot_value 是热度值,label / is_hot / is_new 是榜单标记。
  • 热度值不是搜索人数或阅读次数,url 指向热搜词页面而非单条微博;跨时间对比需要自行保存快照,接口没有历史日期查询参数。

微博 API 常见问题

微博 API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="weibo"、action 和 params。以 search 为例,必填 keyword,没有可选参数。这里使用微博内容搜索词;单条详情的数字 ID 与字母短码不能直接混用。 微博 共 4 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

微博 API 怎么收费?

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

微博 API 一次能返回多少条数据?

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

微博 API 返回哪些字段?

当前目录为 search 列出 id、url、text、posted_at、device、repost_count 等 20 个字段名。按全站当前目录统计,4 个字段名只在 微博 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

「按关键词检索公开微博并区分转发」怎样接入 微博 API?

用 search 收集帖子文本和互动快照,由调用方持续留存对比。 keyword 搜公开帖子;id / url 定位微博,is_repost 区分转发标记,repost_count、comment_count、like_count 分别是转发、评论和点赞数量。 device 是公开的发布客户端信息,不是设备指纹;作者粉丝信息可能缺失,需另查 profile,不能将缺失值当作零粉丝或据搜索样本推断全网声量。

「用微博数字 UID 核对账号档案」怎样接入 微博 API?

用 profile 查看账号资料,不把用户昵称或帖子 ID 当成 UID。 user_id 填数字 UID 或含 /u/数字UID 的主页链接;display_name 是昵称,following_count 是关注数,follower_count 是粉丝数。 post_count 是发帖数量,不是返回了全部帖子;created_at 是账号注册时间,verified_reason 是平台认证说明,不是 EveryInfra 的资质审核。

「用数字帖子 ID 读取微博评论」怎样接入 微博 API?

用 comments 对准一条微博,避免含字母的短码被当成数字 ID。 url 优先填 /detail/纯数字帖子ID 的链接,也可在该字段填数字帖子 ID;当前只提取最后一段数字,不会自动将 base62 短码转换成帖子 ID。 id 是评论 ID,post_id 是被评论的微博 ID;text、author_name、like_count 与 posted_at 描述评论,不包含完整回复树,也不是发评论接口。

「读取微博热搜条目而不是关键词搜索结果」怎样接入 微博 API?

用 trending 保存榜单快照,观察榜上话题及位置变化。 trending 无需 keyword 或 user_id;rank 是返回的榜位,title 是热搜词,hot_value 是热度值,label / is_hot / is_new 是榜单标记。 热度值不是搜索人数或阅读次数,url 指向热搜词页面而非单条微博;跨时间对比需要自行保存快照,接口没有历史日期查询参数。

可以先免费试用 微博 API 吗?

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

开始调用 微博 API

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

免费开始