接口说明

Facebook Post API 获取 Facebook 帖子详情及附带的作者、媒体和评论等数据。

使用 Pangolinfo API Key 调用,返回结构化 JSON 数据。

请求URL

POST https://scrapeapi.pangolinfo.com/api/v1/social/facebook-post

请求头

参数名参数值类型说明
Content-Typeapplication/jsonstring数据格式
AuthorizationBearer xxxstring认证凭证

采集最长约75秒,客户端超时建议设为90秒。

请求参数

参数必填类型说明
targetYesstring帖子链接(支持短链,不支持直接传 id)

仅处理本页列出的请求参数,其他字段忽略。分页游标原样传回,不编码、解码或转换格式。

附带评论限一页;需要继续获取评论时调用对应评论接口。

响应值

返回值类型说明
codeinteger状态码,0 表示成功
messagestring响应信息,成功时为 ok
pointCostnumber本次请求实际消耗的积点
dataobject返回数据,结构见下表
metaobject请求标识及耗时(毫秒)
billingobject计费条数、单价及规则版本

返回参数 data 说明

返回值类型说明
typestringType
可用值: [“post”]
posterobject作者; 部分视频 (watch / reel) 匿名拿不到, 全为 null
postobject帖子; 解析失败时只有前 4 个字段
commentsobject[]顶层评论
paginationobject评论分页

data.poster 字段说明

返回值类型说明
nicknamestring | null作者名字
avatarstring | null作者头像
profileUrlstring | null作者主页
idstring | null作者 id
typestring | null作者类型: User / Page

data.post 字段说明

返回值类型说明
likesnumber | null回应总数 (点赞 + 其他表情); 匿名视频帖常为 null
commentsCountnumber | null评论数
viewsnumber | null播放数 (视频); 非视频为 null
publishedAtstring | null发布时间 ISO (兼容旧格式, 是字符串)
captionTextstring | null正文
postIdstring | null帖子 id
urlstring请求的链接
createdTimenumber | null发布时间毫秒时间戳
sharesnumber | null分享数; 匿名通常拿不到
playsnumber | null播放数 (play_count)
videoViewsnumber | null观看数 (video_view_count)
feedbackIdstring | null评论接口用的 feedback id (base64)
permalinkstring | null帖子规范链接
titlestring | null标题; Facebook 帖子一般没有, 为 null
reactionsobject[]按表情的回应数 (前几名); 拿不到为空
hashtagsstring[]正文话题 (不含 #)
linksstring[]正文外链
attachmentsobject[]附件 (图片 / 视频 / 链接卡片)
videoobject | null视频信息; 非视频帖为 null

data.post.reactions[] 字段说明

返回值类型说明
typestring | null表情类型, 如 Like / Love / Haha
countnumber | null数量

data.post.attachments[] 字段说明

返回值类型说明
typestring | null附件类型: Video / Photo / ExternalUrl …
idstring | null附件 id
urlstring | null链接
thumbnailstring | null缩略图
widthnumber | null宽
heightnumber | null高

data.post.video 字段说明

返回值类型说明
idstring视频 id
durationSecnumber | null时长 (秒)
widthnumber | null宽
heightnumber | null高
thumbnailstring | null封面
sdUrlstring | null标清地址 (有时效)
hdUrlstring | null高清地址 (有时效)
isLiveboolean是否直播

data.comments[] 字段说明

返回值类型说明
avatarstring | null评论者头像
nicknamestring | null评论者名字
profileUrlstring | null评论者主页
timeTextobject | null评论时间 (text 为 ISO)
contentstring | null评论内容
moodnumber | null评论的回应 (点赞) 数; 0 时为 null
idstring | null评论 id (base64); 回复模式传 options.commentId 用它
legacyIdstring | null评论数字 id
authorIdstring | null评论者 id (可能是 pfbid 加密 id)
authorTypestring | null评论者类型: User / Page
replyCountnumber回复数
urlstring | null评论链接
depthnumber层级: 0 顶层, 1 回复
parentIdstring | null父评论 id; 顶层为 null
replyCursorstring | null回复首页游标: 回复模式传 options.cursor (与 commentId 一起); 无回复为 null, 有时效

data.comments[].timeText 字段说明

返回值类型说明
textstring | null上游原始时间文本
valuenumber | null解析后的毫秒时间戳; 解析失败为 null

data.pagination 字段说明

返回值类型说明
commentsobjectComments

data.pagination.comments 字段说明

返回值类型说明
cursorstring | null下一页游标, 传回 options.cursor 续取
hasMoreboolean是否还有更多

请求示例

curl --request POST \
  --url https://scrapeapi.pangolinfo.com/api/v1/social/facebook-post \
  --header 'Authorization: Bearer YOUR_PANGOLINFO_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "target": "https://www.facebook.com/watch/?v=28751926967826750"
}'

返回示例

下例截取实际响应中的首条列表记录,长文本与链接作了缩写;pointCost 为该次完整响应的实际费用。完整字段结构可在在线调试页查看。

{
  "code": 0,
  "message": "ok",
  "pointCost": 0.8,
  "data": {
    "type": "post",
    "poster": {
      "nickname": "Nate Petroski",
      "avatar": "https://scontent.ffru11-1.fna.fbcdn.net/v/t39.30808-1/352211230_2277627632410124_7647155118717881704_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx2048x2048&ctp=s40x40&_n...",
      "profileUrl": "https://www.facebook.com/nateandminion",
      "id": "100090990872146",
      "type": "User"
    },
    "post": {
      "likes": 1250,
      "commentsCount": 20,
      "views": 11955,
      "publishedAt": "2026-09-21T23:00:35.000Z",
      "captionText": "Charging tools and gadgets in the woods with the jackery Homepower 3600 plus\n#narrowayhomestead #offgrid #jackery #poweroutjackeryon #HomePower3600Plus #prim...",
      "postId": "1038003932575960",
      "url": "https://www.facebook.com/watch/?v=28751926967826750",
      "createdTime": 1790031635000,
      "shares": null,
      "plays": 25852,
      "videoViews": 11955,
      "feedbackId": "ZmVlZGJhY2s6cGZiaWQwMlQ2a2R1eE03QjdkYWdGMTFnNER2YVF5U01rM0FaWWlZSzRGV2NHaXQxVXlpbVQ4aFFYY2NpYk5yc2VLaFA0TDNs",
      "permalink": "https://www.facebook.com/reel/28751926967826750/",
      "title": null,
      "reactions": [
        {
          "type": "Like",
          "count": 1205
        }
      ],
      "hashtags": [
        "narrowayhomestead"
      ],
      "links": [
        "https://bit.ly/4hd9LaE"
      ],
      "attachments": [],
      "video": {
        "id": "28751926967826750",
        "durationSec": 87.6,
        "width": 1080,
        "height": 1920,
        "thumbnail": "https://scontent.ffru11-1.fna.fbcdn.net/v/t15.5256-10/819220765_933120436078076_3522944100965256075_n.jpg?stp=dst-jpg_tt6&cstp=mx1080x1920&ctp=s960x960&_nc_c...",
        "sdUrl": "https://video.ffru11-1.fna.fbcdn.net/o1/v/t2/f2/m412/AQO0iWXE5sq_mLSkYgF4mBVpmO8GJLbVwqPC87il6lxSJYh8tX2YzNsreKKl4-dM7Pq6XIDgxw1efzQMvQ_HL2uasUCDJl0dhXFGmAgQ...",
        "hdUrl": "https://video.ffru11-1.fna.fbcdn.net/o1/v/t2/f2/m412/AQN1M47TQ-95qzA4Ctt31OrlWf0UMW5R0EeZAoGv-vPAJQ22Tcc8f6np9sc18IXr4ACB5kjPZkK-NvbOEc8hse4sMnB5FDEDNSxWeEib...",
        "isLive": false
      }
    },
    "comments": [
      {
        "avatar": "https://scontent.ffru11-1.fna.fbcdn.net/v/t39.30808-1/830541597_10165061607287628_7626207140813021480_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx720x720&ctp=s32x32&_nc...",
        "nickname": "Tony Gibson",
        "profileUrl": "https://www.facebook.com/tony.gibson.3154",
        "timeText": {
          "text": "2026-09-21T23:32:36.000Z",
          "value": 1790033556000
        },
        "content": "We bought one almost a year ago and it has been awesome running power tools it’s piece of mine knowing if the electric goes out it can be used for various th...",
        "mood": 3,
        "id": "Y29tbWVudDoxMDM4MDAzOTMyNTc1OTYwXzIzNTI1MTc5Njg2MTk5OTQ=",
        "legacyId": "2352517968619994",
        "authorId": "pfbid02QenCGVC6HrcBcPWrdqcURw1j1JQLi2uwkKbNZYxhcmPGjFvNVKzyz74jWjgkWj9ul",
        "authorType": "User",
        "replyCount": 0,
        "url": "https://www.facebook.com/reel/28751926967826750/?comment_id=2352517968619994",
        "depth": 0,
        "parentId": null,
        "replyCursor": null
      }
    ],
    "pagination": {
      "comments": {
        "cursor": "MToxNzkzOTU0Mjk1OgF_r0bYz6nZSgD9bp-3qx_d96Npk7aa0SbrK_PXnnwyJxQnoIWgCSLm_1tqfMUE9QYrc6axGl-MAq-6DjQCnPkNa6Yz79mLxZoGrEh9WxPXI_szznDthrBnHilmaliTtiS0KbgWWVlUB...",
        "hasMore": true
      }
    }
  },
  "meta": {
    "requestId": "pg-audit-r1-facebook-post-1793954288138582000",
    "durationMs": 8992
  },
  "billing": {
    "unitPrice": 0.8,
    "ruleVersion": "social-primary-v2",
    "billedCount": 1,
    "pointCost": 0.8
  }
}

积点消耗说明

每条帖子、视频或商家主体消耗 0.8 积点,附带评论、回复和作者资料免费。

空结果、失败响应不扣费。同一响应中相同 ID 只计一次,独立调用和续页分别计费。详见 社媒评论 API 计费说明。

在线调试