Collect Facebook Posts by Keyword

Keyword collection runs asynchronously: this call creates the task and returns its id; read the matched posts from the task-result endpoint.

GET/api/v1/facebook/task/post/search

Quota usage: Each successful request to this endpoint deducts 1 quota units from your plan.

Request Parameters

Name	In	Type	Description
`query`	query	string	Search keyword

Name	In	Type	Description
`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

Request URL

https://openapi.scdata.cc/api/v1/facebook/task/post/search

Authorization

Select an API key from Dashboard

Add an API key before sending a request.Go to Dashboard

query*

limit

recent_posts

publish_at_start

publish_at_end

bash

curl -X GET "https://openapi.scdata.cc/api/v1/facebook/task/post/search?query=example" \
  -H "Authorization: YOUR_API_KEY"

json

{
  "success": true,
  "code": 200,
  "message": "Request successful",
  "data": {
    "task_id": "string",
    "task_status": "string"
  }
}

Brand mention tracking — Collect public posts that mention a brand or campaign hashtag.
Trend research — Gauge how much conversation a topic generates on Facebook.