前提条件
- 一个 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 格式。
/scrape 端点专为实时的单 URL 请求设计。它最多支持 20 个 URL，最多等待 1 分钟。如果采集耗时更长，响应为 HTTP 202，返回 snapshot_id 而不是数据，采集将继续以异步方式进行。请通过异步请求获取结果，或使用 Webhook 投递接收结果。个人资料
数据集 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 响应。处理时间取决于目标网站状况和爬虫负载。
示例响应
示例响应
[
{
"name": "Mark Zuckerberg",
"url": "https://www.facebook.com/zuck",
"id": "4",
"profile_photo": "https://scontent-phl2-1.xx.fbcdn.net/v/t39.30808-1/632598281_10117314650513371_3238643608998008744_n.jpg?stp=dst-jpg_tt6&cstp=mx711x711&ctp=s200x200&_nc_cat=...",
"cover_photo": "https://scontent-phl2-1.xx.fbcdn.net/v/t39.30808-6/632550896_10117314656231911_7975049830116595629_n.png?stp=dst-png&cstp=mx820x360&ctp=s820x360&_nc_cat=110&...",
"location": "Palo Alto, California",
"city": "Palo Alto"
}
]
页面帖子
数据集 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/reel/28631238109803230/",
"num_comments": 82,
"date_posted": "2026-09-04T15:07:02.000Z",
"post_id": "1620874212741282",
"user_url": "https://www.facebook.com/NASA",
"user_username_raw": "NAS***n",
"content": "AvGeeks, assemble!\n\nMAX POWER, America’s newest and most exciting aerospace technology expo and air show, is touching down in Florida on Nov. 7–8.\n\nJUST CONF...",
"num_shares": 62,
"page_name": "NASA - National Aeronautics and Space Administration",
"profile_id": "100044561550831"
}
]
按帖子 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/NASA/posts/pfbid0QexwhJRkRC4FUvxx3hcNUkMVZNwTh4mgVi8tbJMAk4nWEaWd3KTiZxAhRc4br2yYl"}]'
示例响应
示例响应
[
{
"url": "https://www.facebook.com/NASA/posts/pfbid0QexwhJRkRC4FUvxx3hcNUkMVZNwTh4mgVi8tbJMAk4nWEaWd3KTiZxAhRc4br2yYl",
"num_comments": 83,
"date_posted": "2026-09-02T20:52:09.000Z",
"post_id": "1619357056226331",
"user_url": "https://www.facebook.com/NASA",
"user_username_raw": "NAS***n",
"content": "Red Moon over Louisiana\n\nOn the night of Aug. 27-28, the full moon slipped through Earth's shadow, creating a near-total lunar eclipse for skywatchers in the...",
"num_shares": 164,
"profile_id": "100044561550831",
"page_logo": "https://scontent-nrt6-1.xx.fbcdn.net/v/t39.30808-1/243095782_416661036495945_3843362260429099279_n.png?stp=dst-png&cstp=mx800x800&ctp=s200x200&_nc_cat=1&ccb=..."
}
]
市场
数据集 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/NASA/posts/pfbid0QexwhJRkRC4FUvxx3hcNUkMVZNwTh4mgVi8tbJMAk4nWEaWd3KTiZxAhRc4br2yYl"}]'
示例响应
示例响应
[
{
"url": "https://www.facebook.com/NASA/posts/pfbid0QexwhJRkRC4FUvxx3hcNUkMVZNwTh4mgVi8tbJMAk4nWEaWd3KTiZxAhRc4br2yYl?locale=en_US",
"comment_text": "Rayleigh scattering filtering out blue light explains that red moon color same physics as sunsets nice that they captured it from michoud where sls rockets a...",
"post_id": "pfbid0QexwhJRkRC4FUvxx3hcNUkMVZNwTh4mgVi8tbJMAk4nWEaWd3KTiZxAhRc4br2yYl",
"post_url": "https://www.facebook.com/NASA/posts/pfbid0QexwhJRkRC4FUvxx3hcNUkMVZNwTh4mgVi8tbJMAk4nWEaWd3KTiZxAhRc4br2yYl?locale=en_US",
"comment_id": "Y29tbWVudDoxNjE5MzU3MDU2MjI2MzMxXzEwNjQ1NzgzOTMyMjAzNTQ=",
"user_name": "Tus***a",
"user_id": "615***",
"date_created": "2026-09-03T00:51:39.000Z",
"num_likes": 2,
"num_replies": 0
}
]
快速参考：数据集 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 参考
完整的参数和响应字段参考。