curl --request POST \
  --url https://api.socq.ai/v1/facebook/comments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "urls": [
    "https://www.facebook.com/facebook/posts/POST_ID"
  ]
}
'

{
  "code": 200,
  "data": {
    "task_id": "A1B2C3D4E5F6G7H8",
    "status": "queued",
    "created_time": "2023-11-07T05:31:56Z"
  }
}

{
  "code": 123,
  "error": {
    "message": "<string>",
    "type": "<string>"
  }
}

{
  "code": 123,
  "error": {
    "message": "<string>",
    "type": "<string>"
  }
}

{
  "code": 123,
  "error": {
    "message": "<string>",
    "type": "<string>"
  }
}

POST

facebook

comments

curl --request POST \
  --url https://api.socq.ai/v1/facebook/comments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "urls": [
    "https://www.facebook.com/facebook/posts/POST_ID"
  ]
}
'

{
  "code": 200,
  "data": {
    "task_id": "A1B2C3D4E5F6G7H8",
    "status": "queued",
    "created_time": "2023-11-07T05:31:56Z"
  }
}

{
  "code": 123,
  "error": {
    "message": "<string>",
    "type": "<string>"
  }
}

{
  "code": 123,
  "error": {
    "message": "<string>",
    "type": "<string>"
  }
}

{
  "code": 123,
  "error": {
    "message": "<string>",
    "type": "<string>"
  }
}

Facebook Comments

Collect public Facebook comment data for public post URLs, including comment text, author fields, engagement metrics, and raw JSONL output.

Endpoint

POST https://api.socq.ai/v1/facebook/comments

Request Body

{
  "urls": ["https://www.facebook.com/facebook/posts/POST_ID"]
}

All returned comments are billed by the actual result count. This endpoint does not accept a result-count limit.

Result Item

After the task succeeds, call GET /v1/tasks/{task_id} to read paginated standard records under results.

{
  "id": "1569965031842178_123456789",
  "platform": "facebook",
  "resource": "comments",
  "type": "comment",
  "url": "https://www.facebook.com/facebook/posts/POST_ID",
  "text": "Comment text",
  "author": {
    "id": "100064860875397",
    "username": "facebook",
    "name": "facebook",
    "url": "https://www.facebook.com/facebook/",
    "avatar_url": null,
    "is_verified": null,
    "is_private": null
  },
  "metrics": {
    "likes_count": 18,
    "replies_count": 2
  },
  "media": [],
  "created_at": "2026-07-07T19:17:33",
  "collected_at": "2026-07-08T08:59:45",
  "extra": {
    "post_id": "1569965031842178",
    "post_url": "https://www.facebook.com/facebook/posts/POST_ID",
    "parent_comment_id": null,
    "input_url": "https://www.facebook.com/facebook/posts/POST_ID"
  }
}

Response

{
  "code": 200,
  "data": {
    "task_id": "A1B2C3D4E5F6G7H8",
    "status": "queued",
    "created_time": "2026-07-08T10:30:00"
  }
}

Authorizations

Authorization

string

header

required

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

Body

application/json

urls

string[]

required

Array of public post URLs to collect comments from.

Minimum array length: 1

callback_url

string

Optional callback URL

Response

Task submitted

code

integer

Example:

200

data

object

Show child attributes

Facebook Posts Facebook Marketplace

⌘I

Overview

Instagram

Facebook

Facebook Marketplace

Facebook Ad Library

YouTube

TikTok

TikTok Shop

X

LinkedIn

Reddit

Pinterest

Threads

Common

Facebook Comments

Facebook Comments

Endpoint

Request Body

Result Item

Response

Authorizations

Body

Response

​Facebook Comments

​Endpoint

​Request Body

​Result Item

​Response

Authorizations

Body

Response

Facebook Comments

Endpoint

Request Body

Result Item

Response