Die Stichwort-Erfassung läuft asynchron: Dieser Aufruf erstellt die Aufgabe und liefert ihre ID; die gefundenen Beiträge liest der Ergebnis-Endpunkt.
GET
/api/v1/facebook/task/post/searchKontingentverbrauch: Jede erfolgreiche Anfrage an diesen Endpunkt zieht 1 Kontingenteinheiten von Ihrem Plan ab.
Request-Parameter
Pflichtparameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
query | query | string | Search keyword |
Optionale Parameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
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 |
Antwortfelder
| Name | Typ | Beschreibung |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.task_id | string | Task ID |
data.task_status | string | Task status |
Ausprobieren
https://openapi.scdata.cc/api/v1/facebook/task/post/search
API-Schlüssel aus dem Dashboard auswählen
Fügen Sie einen API-Schlüssel hinzu, bevor Sie eine Anfrage senden.Zum Dashboard
Query-Parameter
query*limitrecent_postspublish_at_startpublish_at_endcURL-Beispiel
bash
curl -X GET "https://openapi.scdata.cc/api/v1/facebook/task/post/search?query=example" \-H "Authorization: YOUR_API_KEY"
Antwortbeispiel (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": {"task_id": "string","task_status": "string"}}
Anwendungsfälle
- Marken-Erwähnungen verfolgen — Sammeln Sie öffentliche Beiträge, die eine Marke oder einen Kampagnen-Hashtag erwähnen.
- Trendrecherche — Messen Sie, wie viel Gesprächsstoff ein Thema auf Facebook erzeugt.