发送您的第一个Facebook API请求

本指南介绍如何向每个 Bright Data Facebook Scraper API 端点发送同步请求。完成后，你将拥有用于个人资料、页面帖子、帖子、市场列表和评论的工作示例。

前提条件

一个 Bright Data 账户配有有效的 API key
已完成快速入门

请求结构

每个同步请求都遵循相同的模式：

POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.facebook.com/..."}]

端点之间唯一改变的是 dataset_id 和输入 URL 格式。

同步请求最多支持 20 个 URL，超时时间为 1 分钟。如果请求耗时较长，API 会自动返回 snapshot_id。请参阅异步请求。

个人资料

数据集 ID： gd_mf0urb782734ik94dz

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_mf0urb782734ik94dz&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/zuck"}]'

你应该会看到 200 响应。这需要 10-30 秒。

示例响应

[
  {
    "name": "Mark Zuckerberg",
    "url": "https://www.facebook.com/zuck",
    "followers": 120000000,
    "bio": "Building the future...",
    "profile_type": "public_figure",
    "is_verified": true
  }
]

完整个人资料响应模式

页面帖子

数据集 ID： gd_lkaxegm826bjpoo9m5

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lkaxegm826bjpoo9m5&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/NASA"}]'

示例响应

[
  {
    "url": "https://www.facebook.com/NASA",
    "post_text": "Exploring the cosmos...",
    "num_comments": 450,
    "date_posted": "2024-04-10T14:30:00.000Z",
    "reactions": 12500,
    "content_type": "Photo"
  }
]

完整页面帖子响应模式

按帖子 URL 获取帖子

数据集 ID： gd_lyclm1571iy3mv57zw

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lyclm1571iy3mv57zw&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/zuck/posts/example123"}]'

示例响应

[
  {
    "url": "https://www.facebook.com/zuck/posts/example123",
    "post_text": "Excited to share...",
    "num_comments": 320,
    "date_posted": "2024-05-01T09:00:00.000Z",
    "reactions": 8500,
    "shares": 1200
  }
]

完整帖子响应模式

市场

数据集 ID： gd_lvt9iwuh6fbcwmx1a

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lvt9iwuh6fbcwmx1a&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/marketplace/item/123456789"}]'

示例响应

[
  {
    "url": "https://www.facebook.com/marketplace/item/123456789",
    "title": "Vintage Coffee Table",
    "price": "$150",
    "location": "San Francisco, CA",
    "seller_name": "John Doe",
    "description": "Beautiful mid-century modern coffee table..."
  }
]

完整市场响应模式

数据集 ID： gd_lkay758p1eanlolqw8

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lkay758p1eanlolqw8&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.facebook.com/zuck/posts/example123"}]'

示例响应

[
  {
    "url": "https://www.facebook.com/zuck/posts/example123",
    "comment_user": "Jane Smith",
    "comment_date": "2024-05-02T10:15:00.000Z",
    "comment_text": "Great update!",
    "reactions": 12,
    "replies_count": 3
  }
]

完整评论响应模式

快速参考：数据集 ID

端点	数据集 ID	URL 格式
按个人资料 URL 获取页面帖子	`gd_lkaxegm826bjpoo9m5`	`facebook.com/{page_name}`
评论	`gd_lkay758p1eanlolqw8`	`facebook.com/{user}/posts/{post_id}`
按群组 URL 获取帖子	`gd_lz11l67o2cb3r0lkj3`	`facebook.com/groups/{group_id}`
按帖子 URL 获取帖子	`gd_lyclm1571iy3mv57zw`	`facebook.com/{user}/posts/{post_id}`
市场	`gd_lvt9iwuh6fbcwmx1a`	`facebook.com/marketplace/item/{item_id}`
个人资料	`gd_mf0urb782734ik94dz`	`facebook.com/{username}`
页面和个人资料	`gd_mf124a0511bauquyow`	`facebook.com/{page_or_profile}`
活动	`gd_m14sd0to1jz48ppm51`	`facebook.com/events/{event_id}`
按个人资料 URL 获取短视频	`gd_lyclm3ey2q6rww027t`	`facebook.com/{username}`
公司评论	`gd_m0dtqpiu1mbcyc2g86`	`facebook.com/{company_page}`

输出格式

使用 format 查询参数控制响应格式：

值	描述
`json`	JSON 数组（默认）
`ndjson`	换行分隔的 JSON，每行一条记录
`csv`	逗号分隔值

异步批量请求

在单个批处理作业中抓取数百个 URL。

API 参考

完整的参数和响应字段参考。

快速开始

数据提取

Web 访问

AI 训练数据

代理网络

发送您的第一个Facebook API请求

前提条件

请求结构

个人资料

页面帖子

按帖子 URL 获取帖子

市场

评论

快速参考：数据集 ID

输出格式

相关内容

异步批量请求

API 参考

​前提条件

​请求结构

​个人资料

​页面帖子

​按帖子 URL 获取帖子

​市场

​评论

​快速参考：数据集 ID

​输出格式

​相关内容

异步批量请求

API 参考

前提条件

请求结构

个人资料

页面帖子

按帖子 URL 获取帖子

市场

评论

快速参考：数据集 ID

输出格式

相关内容