Facebook获取帖子详情

最低 ¥0.04/次起即将上线

通过帖子URL获取帖子完整信息（含reactions表情细分）

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

POSThttps://redfox.hk/story/api/fb/postDetail

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/fb/postDetail

请求头

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

请求参数

参数类型必填说明示例
urlstring是Facebook帖子URL（必填） 例：https://www.facebook.com/reel/1746412686633900https://www.facebook.com/reel/1746412686633900

返回值与结构

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

响应字段

字段类型说明示例
codeinteger响应状态码，2000表示成功2000
msgstring响应消息成功
dataobject
authorobject帖子作者信息
avatarstring作者头像URL（带签名临时链接，有时效性）https://scontent-sea5-1.xx.fbcdn.net/v/t39.30808-1/375581796_..._n.jpg?oh=00_AQO3sMS...&oe=6ADE18F9
displayNamestring作者显示名称爱讲故事的英俊小马
idstring作者主页ID（字符串型）100075641569390
captionstring帖子正文文本（含话题标签，无文字时为null）事實證明，這是擺脫海洋垃圾的答案 #reels #科普 #科普知識
commentCountinteger评论数量662
engagementRatenumber互动率（互动总数/触达人数，小数型，如0.01723即1.723%）0.01723
estimatedReachinteger预估触达人数（帖子覆盖的独立用户数）4852615
feedbackIdstring帖子互动反馈ID（Base64编码，用于查询评论线程）ZmVlZGJhY2s6MTEwMjYzNzM1ODkzNDMwNg==
imageUrlstring视频封面图URL（视频帖的封面缩略图）https://scontent-sea5-1.xx.fbcdn.net/v/t15.5256-10/800538774_..._n.jpg?oh=00_AQNvfF7J...&oe=6ADE0F79
likeCountinteger点赞总数（各类reaction之和）65112
mediaTypestring媒体类型：video-视频帖，photo-图片帖video
mediaUrlsarray媒体资源URL列表（视频帖封面走imageUrl，此列表可为空）
permalinkstring帖子永久链接（reel为短视频/快拍类型）https://www.facebook.com/reel/1746412686633900
playCountinteger视频播放次数4043846
postIdstring帖子唯一ID（字符串型）1102637358934306
publishedAtstring帖子发布时间（ISO 8601 UTC格式）2026-10-14T12:03:23.000Z
reactionAngerinteger「愤怒」表情回应数（😠）4
reactionCareinteger「关心」表情回应数（Facebook特有类型，❤️‍🩹）88
reactionHahainteger「哈哈」表情回应数（😆）23
reactionLikeinteger「赞」表情回应数（👍）64425
reactionLoveinteger「爱心」表情回应数（❤️）431
reactionSorrynull「难过」表情回应数（😢，无数据时为null）
reactionSupportnull「支持」表情回应数（部分场景才有，无数据时为null）
reactionWowinteger「惊讶」表情回应数（😮）139
shareCountinteger分享次数3900
videoDurationnumber视频时长（秒，浮点型含毫秒精度）51.942
videoUrlnull视频播放地址（该接口未返回直链时为null，需通过permalink访问）

请求示例

{
    "url": "https://www.facebook.com/reel/1746412686633900"
}

响应示例

{
  "code": 2000,
  "data": {
    "author": {
      "avatar": "https://scontent-sea5-1.xx.fbcdn.net/v/t39.30808-1/375581796_..._n.jpg?oh=00_AQO3sMS...&oe=6ADE18F9",
      "displayName": "爱讲故事的英俊小马",
      "id": "100075641569390"
    },
    "caption": "事實證明，這是擺脫海洋垃圾的答案  #reels #科普 #科普知識",
    "commentCount": 662,
    "engagementRate": 0.01723,
    "estimatedReach": 4852615,
    "feedbackId": "ZmVlZGJhY2s6MTEwMjYzNzM1ODkzNDMwNg==",
    "imageUrl": "https://scontent-sea5-1.xx.fbcdn.net/v/t15.5256-10/800538774_..._n.jpg?oh=00_AQNvfF7J...&oe=6ADE0F79",
    "likeCount": 65112,
    "mediaType": "video",
    "mediaUrls": [],
    "permalink": "https://www.facebook.com/reel/1746412686633900",
    "playCount": 4043846,
    "postId": "1102637358934306",
    "publishedAt": "2026-10-14T12:03:23.000Z",
    "reactionAnger": 4,
    "reactionCare": 88,
    "reactionHaha": 23,
    "reactionLike": 64425,
    "reactionLove": 431,
    "reactionSorry": null,
    "reactionSupport": null,
    "reactionWow": 139,
    "shareCount": 3900,
    "videoDuration": 51.942,
    "videoUrl": null
  },
  "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操作过于频繁，请稍后再试触发频率限制，降低请求频率或增加调用间隔后重试。