微博关键词搜索作品

最低 ¥0.03/次起即将上线需配置 API Key

单价随接口累计调用量阶梯调整

POSThttps://redfox.hk/story/api/weibo/ability/searchWork

API 密钥获取与配置

获取密钥

调用 API 前，请先在控制台生成 API 密钥并完成配置。在 HTTP 请求头中添加API Key 字段，密钥用于身份校验与额度计费。

获取步骤

  1. 前往控制台页面，进入 API 密钥管理模块。
  2. 若无已生成的密钥，点击生成新密钥，复制并妥善保存密钥。
  3. 在请求头中添加 REDFOX_API_KEY或X-API-KEY字段并填入密钥后即可调用。

API说明

Method：POST

Host：https://redfox.hk

Path：/story/api/weibo/ability/searchWork

请求头

名称类型必填说明示例
REDFOX_API_KEYstring是平台鉴权令牌，每次请求必填ak_xxxxxx
Content-Typestring是请求体数据类型application/json

请求参数

参数类型必填说明示例
searchTypestring否搜索类别：1:综合；3:搜索账号；60:热门；61:实时博文；必填61
pagestring否页码 必填1
keywordstring否关键词 必填中国散打队六金
extParamstring否认证类别："机构认证":"3" "个人认证":"2" "普通用户":"0"；不传则为搜索博文。非必填

返回值与结构

统一包装一般为 `code`、`message`/`msg`、`data`（以实际服务为准）。

响应字段

字段类型说明示例
commentNuminteger评论数
forwardNuminteger转发数
imagesarray图片列表
likeNuminteger点赞数
nicknamestring用户昵称
opusIdstring作品ID
publishTimestring发布时间
textstring博文内容
topicsarray话题列表
typestring类型（如pictures、video、hudongvote等）
uidstring用户UID
updateTimestring更新时间
urlstring博文链接

请求示例

# 暂无示例

响应示例

{
  "code": 2000,
  "data": [
    {
      "commentNum": 0,
      "forwardNum": 0,
      "images": [],
      "likeNum": 0,
      "nickname": "帅的被人追几近狂妄",
      "opusId": "5346646387069813",
      "publishTime": "2026-09-24 12:14:57",
      "text": "#中国武术12枚金牌收官# 中国散打一小时连夺6金这件事，值得认真看一看。伊朗队一直是散打项目的主要劲敌，2018年雅加达亚运会上就有6项决赛对阵伊朗选手。但本届亚运会，中国散打在决赛中依然保持全胜。这不是运气，是技术体系的优势——中国散打选手在踢、打、摔、拿四大技术环节上的均衡性，以及对 ​",
      "topics": [
        "中国武术12枚金牌收官"
      ],
      "type": "pictures",
      "uid": "6357580435",
      "updateTime": "2026-09-24 15:03:38",
      "url": "http://weibo.com/6357580435/5346646387069813"
    },
    {
      "commentNum": 0,
      "forwardNum": 0,
      "images": [
        "https://wx4.sinaimg.cn/orj1080/005ZjWSYgy1ihelh2q6tnj30u01hcgul.jpg",
        "https://wx4.sinaimg.cn/orj1080/005ZjWSYgy1ihelh1wa2vj30u01hcn67.jpg",
        "https://wx3.sinaimg.cn/orj1080/005ZjWSYgy1ihelh3cgzjj30u01hcaj6.jpg",
        "https://wx2.sinaimg.cn/orj1080/005ZjWSYgy1ihelh3zty2j30u01hck0f.jpg",
        "https://wx3.sinaimg.cn/orj1080/005ZjWSYgy1ihelh4q2nqj30u01hctho.jpg",
        "https://wx3.sinaimg.cn/orj1080/005ZjWSYgy1ihelh5gs88j30u01hc7da.jpg",
        "https://wx3.sinaimg.cn/orj1080/005ZjWSYgy1ihelh6vq3qj30u01kjahk.jpg"
      ],
      "likeNum": 20,
      "nickname": "发呆被星星抓拍",
      "opusId": "5346633403598821",
      "publishTime": "2026-09-24 11:23:22",
      "text": "#中国散打包揽参赛项目全部金牌#\n名古屋亚运会武术散打赛场，中国队出战6个项目，全部拿下金牌！\n🥇吴迪｜女子52kg\n🥇张晓雨｜女子60kg\n🥇欧家铭｜男子56kg\n🥇唐思硕｜男子60kg\n🥇汪成锦｜男子65kg\n🥇马硕｜男子70kg\n\n中国散打队六位选手在名古屋亚运赛场力克劲敌，将所有参赛项目金牌收入 ​",
      "topics": [
        "中国散打包揽参赛项目全部金牌"
      ],
      "type": "ai_summary",
      "uid": "5486775248",
      "updateTime": "2026-09-24 15:03:38",
      "url": "http://weibo.com/5486775248/5346633403598821"
    },
    {
      "commentNum": 0,
      "forwardNum": 0,
      "images": [
        "https://wx1.sinaimg.cn/orj1080/dc20a9b9ly1iheifdjiy6j20u01hcnag.jpg",
        "https://wx3.sinaimg.cn/orj1080/dc20a9b9ly1iheifdjgkjj20u01hc7hl.jpg",
        "https://wx2.sinaimg.cn/orj1080/dc20a9b9ly1iheifj1o9vj20u01hck4s.jpg",
        "https://wx1.sinaimg.cn/orj1080/dc20a9b9ly1iheifo92ndj20u01hck4q.jpg",
        "https://wx4.sinaimg.cn/orj1080/dc20a9b9ly1iheifoa1vhj20u01hcgyo.jpg",
        "https://wx3.sinaimg.cn/orj1080/dc20a9b9ly1iheifsgznhj20u01hck4n.jpg"
      ],
      "likeNum": 3,
      "nickname": "中国体育报",
      "opusId": "5346607023261028",
      "publishTime": "2026-09-24 09:38:32",
      "text": "【#一小时中国散打6金#】\n\n#散打中国参赛的6金都拿了#祝贺吴迪、张晓雨、欧家铭、唐思硕、汪成锦、马硕夺冠#中华体育精神闪耀名古屋# ​​​",
      "topics": [
        "一小时中国散打6金",
        "散打中国参赛的6金都拿了",
        "中华体育精神闪耀名古屋"
      ],
      "type": "pictures",
      "uid": "3693128121",
      "updateTime": "2026-09-24 15:03:38",
      "url": "http://weibo.com/3693128121/5346607023261028"
    },
    {
      "commentNum": 0,
      "forwardNum": 0,
      "images": [],
      "likeNum": 10,
      "nickname": "倪天麒-Neo",
      "opusId": "4430748800672693",
      "publishTime": "2019-10-24 02:44:56",
      "text": "从国家散打队报名情况来看，这次我们报了八个单项，拿下六金。在男子70kg这个级别，李昭阳输的对手莫森是现在整个伊朗队的骄傲，武术世锦赛70kg的卫冕冠军，侯赛因的徒弟，这场输能理解。但中国武术受到的冲击绝对不是这一两年间偶然形成，再这么下去，未来武术项目前面能不能加中国二字都有待商榷了。",
      "topics": [],
      "type": "pictures",
      "uid": "1106081707",
      "updateTime": "2026-09-24 15:03:38",
      "url": "http://weibo.com/1106081707/4430748800672693"
    }
  ],
  "msg": "成功"
}

常见状态码说明

调用接口时，响应体中的 code 字段对应以下状态码。完整列表请查看 API 状态码说明页。

状态码说明排查建议
400请求参数错误检查请求体、Query 参数是否与文档一致，必填项是否齐全。
401鉴权失败确认请求头已添加 REDFOX_API_KEY 或 X-API-KEY，且密钥有效、未禁用。
403无权限访问当前密钥或账号无权调用该接口，请检查密钥状态与接口权限。
500系统内部错误服务端异常，请稍后重试；持续出现请联系技术支持。
503服务暂不可用服务维护或短暂过载，请间隔一段时间后重试。
1001缺少必要参数对照「请求参数」表，补全必填字段。
1002参数格式不正确检查字段类型与格式（如 URL、日期、枚举值）是否符合说明。
1003参数类型错误确认 JSON 中数字、字符串、布尔等类型与文档定义一致。
3103密钥不存在密钥可能已删除或填写错误，请前往控制台核对并重新复制。
3105API Key 已禁用在控制台启用该密钥，或创建新密钥后替换请求头中的值。
3201积分不足账户余额不足以支付本次调用，请前往控制台充值后再试。
3202积分账户不存在账号积分账户异常，请登录控制台确认账户状态。
4004操作过于频繁，请稍后再试触发频率限制，降低请求频率或增加调用间隔后重试。