List Comments

The Comments API reads and manages comments on your posts. Comment threads live on the platform, so these endpoints fetch live: pass the target account_id and the platform post id.

Supported on: meta, instagram, threads, x, bluesky, youtube, linkedin (partial). Platforms without comment support return 403 { "error": "not_supported", "platform", "capability": "comments" }.

GET/v1/comments/:post_id

:post_id is the platform-side post/media id. Pass account_id as a query parameter. Returns normalized comments.

GET /v1/comments/:post_id
curl "https://api.socialit.com/v1/comments/POST_ID?account_id=sa_..." \
  -H "Authorization: Bearer sk_live_..."
{
  "comments": [
    { "id": "1789...", "text": "Nice!", "author": "fan1", "created_at": "2026-07-12T08:00:00.000Z", "like_count": 3 }
  ]
}

Reply to a Comment

POST/v1/comments/:post_id
POST /v1/comments/:post_id
curl -X POST https://api.socialit.com/v1/comments/POST_ID \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "account_id": "sa_...", "message": "Thanks!" }'
{ "comment": { "id": "1790..." } }

Moderate a Comment

Comment moderation covers several write actions. Each takes account_id in the request body (or query for DELETE).

Hide a comment

POST/v1/comments/:post_id/:comment_id/hide

Supported on meta, instagram, threads, and x.

POST /v1/comments/:post_id/:comment_id/hide
curl -X POST https://api.socialit.com/v1/comments/POST_ID/COMMENT_ID/hide \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "account_id": "sa_..." }'
{
  "ok": true
}

Delete a comment

DELETE/v1/comments/:post_id/:comment_id
DELETE /v1/comments/:post_id/:comment_id
curl -X DELETE "https://api.socialit.com/v1/comments/POST_ID/COMMENT_ID?account_id=sa_..." \
  -H "Authorization: Bearer sk_live_..."
{
  "ok": true
}

Like a comment

POST/v1/comments/:post_id/:comment_id/like
POST /v1/comments/:post_id/:comment_id/like
curl -X POST https://api.socialit.com/v1/comments/POST_ID/COMMENT_ID/like \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "account_id": "sa_..." }'
{
  "ok": true
}

Remove a like

DELETE/v1/comments/:post_id/:comment_id/like
DELETE /v1/comments/:post_id/:comment_id/like
curl -X DELETE "https://api.socialit.com/v1/comments/POST_ID/COMMENT_ID/like?account_id=sa_..." \
  -H "Authorization: Bearer sk_live_..."
{
  "ok": true
}