Skip to main content
POST
Facebook Comment Replies API

Facebook Comment Replies

Collect public replies for a Facebook comment. Results are normalized and billed by the actual saved record count.
Pass the stable post URL and parent comment ID. SOCQ finds the parent comment across comment pages and resolves the provider reply tokens internally. Legacy feedback_id plus expansion_token input remains supported, but those tokens can expire and should not be stored as a reusable request example.

Reply resolution errors

Use with MCP

Use the JSON request body above as the nested input object for socq_execute, or pass the same fields directly to the typed tool. Typed tools also accept _wait_seconds, _result_limit, and _idempotency_key.
A successful submission returns a task_id. Continue with socq_get_task until the task succeeds, then read normalized records from results.items.
See MCP quickstart for the complete submission and polling flow.

Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
comment_id
string
required

A public comment identifier.

Minimum string length: 1
url
string
required

A public content or product URL.

Minimum string length: 1
callback_url
string<uri>
expansion_token
string

The token used to read replies for a Facebook comment.

Minimum string length: 1
feedback_id
string

The parent Facebook comment feedback identifier.

Minimum string length: 1
results_limit
integer
default:100
Required range: 20 <= x <= 2000

Response

Task accepted

code
integer
data
object