キーワード収集は非同期で実行されます。この呼び出しでタスクを作成してIDを返し、一致した投稿はタスク結果エンドポイントから取得します。
GET
/api/v1/facebook/task/post/searchクォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 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
ダッシュボードのAPIキーを選択
リクエストを送信する前にAPIキーを入力してください。ダッシュボードを開く
クエリパラメータ
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上でどれだけ話題になっているかを測ります。