Facebook API 文档

Facebook API: 个人资料 — 按用户 ID 获取简介

通过已知标识符从 Facebook 获取详细的公开个人资料数据,用于对象记录、验证和数据补全。

当对象已知、您的产品需要其当前公开上下文时,请使用“按用户 ID 获取简介”。

方法 GET
实体 个人资料
版本 1
此端点的作用

利用此 API 方法可以构建什么

先查看结果和常见工作流,然后再了解参数和可运行的请求示例。

此端点可以帮助您

响应以规范化的 V2 格式或平台原生的 V1 格式提供可用的个人资料字段。

何时使用

当对象已知、您的产品需要其当前公开上下文时,请使用“按用户 ID 获取简介”。

常见使用场景

记录补全

将公开的 Facebook 字段附加到已知的产品对象上。

数据验证

在后续处理之前验证标识符和当前的公开上下文。

分析准备

将对象详情用作报告、评分和相关请求的输入。

可用版本

响应版本

两个版本完成相同的任务,接受相同的参数。使用切换按钮比较响应结构,并选择您的客户端所需的版本。

响应版本 V2

在本页面切换版本,即可在同一文档 URL 下比较响应结构。

V1 不可用

保持不变的部分

V1 和 V2 的身份验证、必填参数和请求结构均相同。实际上,您只需在构建端点路径和解析响应时选择版本。

版本之间的差异

主要区别在于响应结构。新集成请使用 V2;仅在需要兼容现有客户端契约时保留 V1。

使用方法

如何调用该方法

两个版本使用相同的 API 密钥请求头和相同的查询参数。本文档先展示共享的参数集合,然后展示各版本特定的端点路径和代码片段。

输入参数

共享参数
参数 必填 类型 示例 说明
user_id 是 str 4 所选平台上的数字用户 ID。

各版本的请求路径

V2

复制确切的端点路径、示例 URL 和代码片段时请选择版本。上方的参数列表保持不变。

GET /api/v2/facebook.com/profile/about-by-user-id

规范化格式

代码示例

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/facebook.com/profile/about-by-user-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'user_id=4'
响应示例

按版本查看真实响应

预览保留了关键字段和集合中的前几项,便于您快速浏览响应结构。切换版本会改变 JSON 格式。

响应示例

V2 响应 JSON

已验证示例

此简明 JSON 示例来自 V2 最近一次成功的验证运行。

{
  "success": true,
  "status": "ok",
  "search_context": {
    "user_id": "100044234596005"
  },
  "data": {
    "profile": {
      "user_id": "100044234596005",
      "username": "DwayneJohnson",
      "display_name": "Dwayne The Rock Johnson",
      "alternate_name": null,
      "profile_url": "https://www.facebook.com/DwayneJohnson",
      "verified": true,
      "gender": "male",
      "category": "Public figure",
      "description": "Dwayne The Rock Johnson. 66,022,044 likes · 745,861 talking about this. The official Facebook page for Dwayne \"The Rock\" Johnson.",
      "external_links": [
        {
          "url": "http://therock.komi.io/",
          "label": "therock.komi.io",
          "link_type": "website"
        }
      ],
      "emails": [],
      "phone_numbers": [],
      "followers_count": 66000000,
      "following_count": 23,
      "likes_count": 66022044,
      "talking_about_count": 745861,
      "avatar_url": "https://example.com/image.jpg",
      "banner_url": "https://scontent-ord5-2.xx.fbcdn.net/v/t39.99422-6/738511563_2287489735394419_846629203386166573_n.png?stp=dst-png&cstp=mx2048x1152&ctp=s960x960&_nc_cat=105&ccb=1-7&_nc_sid=cc71…"
    }
  }
}
下一步

继续评估

将本文档作为第一个决策点,然后在将端点接入常规使用之前,继续了解价格、平台覆盖范围和集成规则。

打开 Facebook 平台页面

在实现之前,比较相邻的实体、API 方法分组和相关文档。

打开平台页面

比较 API 方法价格

在扩大使用规模之前,查看此 API 方法在公开价格表中的位置。

查看价格

查看集成规则

通过入门文档确认身份验证、版本管理、重试以及模拟环境与正式环境的差异。

打开文档
常见问题

团队在实现前常问的问题

借助这些解答,判断此 API 方法是否适合您的工作流、版本选择和上线计划。

此 Facebook API 方法返回哪些数据?

该方法针对个人资料执行“按用户 ID 获取简介”操作。下方的简明响应示例展示了确切的字段结构。

应该选择 V1 还是 V2?

新集成请选择 V2,因为它提供规范化的结构。仅在兼容已使用平台原生格式的客户端时使用 V1。

第一个请求需要准备什么?

创建 API 密钥,在请求头中发送它,并提供表格中的必填参数。代码示例中已包含正确的路径和请求结构。