关键词采集为异步执行:本接口创建任务并返回任务 ID,匹配的帖文通过任务结果接口读取。
GET
/api/v1/facebook/task/post/search额度扣减: 本接口每次成功请求会从套餐额度中扣减 1 单位。
请求参数
必填参数
| 名称 | 位置 | 类型 | 说明 |
|---|---|---|---|
query | query | string | Search keyword |
可选参数
| 名称 | 位置 | 类型 | 说明 |
|---|---|---|---|
limit | query | integer | Maximum number of results |
recent_posts | query | string | Only search recent posts (0 = no, 1 = yes) |
publish_at_start | query | string | Publish time from example: 2026-01-01 |
publish_at_end | query | string | Publish time to example: 2026-01-31 |
响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.task_id | string | Task ID |
data.task_status | string | Task status |
在线调试
https://openapi.scdata.cc/api/v1/facebook/task/post/search
请先从 Dashboard 选择一个 API key
发送请求前请先准备一个 API key。前往 Dashboard
查询参数
query*limitrecent_postspublish_at_startpublish_at_endcURL 示例
bash
curl -X GET "https://openapi.scdata.cc/api/v1/facebook/task/post/search?query=example" \-H "Authorization: YOUR_API_KEY"
响应示例 (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": {"task_id": "string","task_status": "string"}}
使用场景
- 品牌提及追踪 — 采集提到品牌或活动标签的公开帖文。
- 趋势调研 — 衡量某话题在 Facebook 上引发的讨论量。