Creator OSDocs

API resource

Comments

List posts with comments

GET/v1/inbox/comments

Works on: Instagram, Facebook, X, Threads, YouTube, LinkedIn (not TikTok)

Your posts that have comments, newest first, across every account. Paginate with cursor.

Query parameters

platformstring

Only this network.

accountIdstring

Only this account.

sinceISO 8601

Posts created after this time.

minCommentsinteger

Skip posts with fewer comments.

limitinteger

Page size.

cursorstring

pagination.nextCursor from the previous page.

curl "https://creatoros-production-5658.up.railway.app/v1/inbox/comments?limit=20" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "data": [
    {
      "id": "post_3JSJJWvgHKZH-Vjy_ggeP792GJbvjQ1pZzbqlPEgKJOO",
      "platform": "instagram",
      "accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
      "accountUsername": "kevbuildsapps",
      "content": "Three hooks that doubled my watch time 👇",
      "permalink": "https://www.instagram.com/reel/C9xYz/",
      "createdTime": "2026-09-18T22:00:04.000Z",
      "commentCount": 312,
      "likeCount": 5120
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "eyJwYWdlIjoyfQ"
  }
}

List comments on a post

GET/v1/inbox/comments/{postId}

Works on: Instagram, Facebook, X, Threads, YouTube, LinkedIn (not TikTok)

Comments with their replies. Each comment says whether you can reply to, hide, like or delete it on that network. Your own comments have from.isOwner: true.

Path parameters

postIdstringrequired

The post_ id from List posts with comments.

Query parameters

accountIdstringrequired

The account (acc_...) the post or conversation belongs to.

limitinteger

Page size.

cursorstring

pagination.cursor from the previous page.

curl "https://creatoros-production-5658.up.railway.app/v1/inbox/comments/post_3JSJJWvgHKZH-Vjy_ggeP792GJbvjQ1pZzbqlPEgKJOO?accountId=acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "status": "success",
  "comments": [
    {
      "id": "cmt_Lr5Tz8Qk2Wx7Ny4Bv1Hm9Jc6Pd3Fs0Ga8Ue5Ki2Oq7X",
      "message": "Where did you learn this? 🔥",
      "createdTime": "2026-09-19T01:12:44.000Z",
      "from": {
        "id": "17841400000000000",
        "username": "maya.fit",
        "isOwner": false
      },
      "likeCount": 4,
      "replyCount": 0,
      "platform": "instagram",
      "replies": [],
      "canReply": true,
      "canDelete": true,
      "canHide": true,
      "canLike": false,
      "isHidden": false
    }
  ]
}

Reply to a comment

POST/v1/inbox/comments/{postId}/reply

Works on: Instagram, Facebook, X, Threads, YouTube, LinkedIn (not TikTok)

Posts a public reply. Include commentId to reply in a thread, or leave it out to comment on the post itself.

Path parameters

postIdstringrequired

The post_ id.

Body

accountIdstringrequired

The account (acc_...) the post or conversation belongs to.

messagestringrequired

Reply text.

commentIdstring

The cmt_ id to reply to.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/inbox/comments/post_3JSJJWvgHKZH-Vjy_ggeP792GJbvjQ1pZzbqlPEgKJOO/reply" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
    "commentId": "cmt_Lr5Tz8Qk2Wx7Ny4Bv1Hm9Jc6Pd3Fs0Ga8Ue5Ki2Oq7X",
    "message": "Thanks Maya! Full breakdown is in my bio 🙌"
  }'
Response 200
{
  "success": true,
  "data": {
    "commentId": "cmt_Wm3Kq9Tz1Vx6Ny4Lb8Hc2Jr5Pd0Fs7Ga3Ue9Ki1Oq4X",
    "isReply": true
  }
}

Reply in DMs

POST/v1/inbox/comments/{postId}/{commentId}/private-reply

Works on: Instagram, Facebook

Sends the commenter a direct message instead of replying publicly. Instagram and Facebook allow one private reply per comment.

Path parameters

postIdstringrequired

The post_ id.

commentIdstringrequired

The cmt_ id.

Body

accountIdstringrequired

The account (acc_...) the post or conversation belongs to.

messagestringrequired

DM text.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/inbox/comments/post_3JSJJWvgHKZH-Vjy_ggeP792GJbvjQ1pZzbqlPEgKJOO/cmt_Lr5Tz8Qk2Wx7Ny4Bv1Hm9Jc6Pd3Fs0Ga8Ue5Ki2Oq7X/private-reply" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
    "message": "Here’s the free guide you asked for: https://example.com/guide"
  }'
Response 200
{
  "success": true
}

Hide a comment

POST/v1/inbox/comments/{postId}/{commentId}/hide

Works on: Instagram, Facebook, Threads, X, and TikTok for Business accounts

Hides a comment from everyone but its author. Reversible: send DELETE to the same path with ?accountId= to unhide.

Path parameters

postIdstringrequired

The post_ id.

commentIdstringrequired

The cmt_ id.

Body

accountIdstringrequired

The account (acc_...) the post or conversation belongs to.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/inbox/comments/post_3JSJJWvgHKZH-Vjy_ggeP792GJbvjQ1pZzbqlPEgKJOO/cmt_Lr5Tz8Qk2Wx7Ny4Bv1Hm9Jc6Pd3Fs0Ga8Ue5Ki2Oq7X/hide" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r"
  }'
Response 200
{
  "success": true
}

Like a comment

POST/v1/inbox/comments/{postId}/{commentId}/like

Works on: Facebook, X, LinkedIn

Likes a comment as the account. Send DELETE to the same path with ?accountId= to unlike.

Path parameters

postIdstringrequired

The post_ id.

commentIdstringrequired

The cmt_ id.

Body

accountIdstringrequired

The account (acc_...) the post or conversation belongs to.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/inbox/comments/post_3JSJJWvgHKZH-Vjy_ggeP792GJbvjQ1pZzbqlPEgKJOO/cmt_Lr5Tz8Qk2Wx7Ny4Bv1Hm9Jc6Pd3Fs0Ga8Ue5Ki2Oq7X/like" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r"
  }'
Response 200
{
  "success": true
}

Delete a comment

DELETE/v1/inbox/comments/{postId}/{commentId}

Works on: Instagram, Facebook, Threads, X, YouTube, LinkedIn, and TikTok for Business accounts

Permanently deletes a comment. You can always delete comments on your own posts; deleting other people’s comments depends on the network.

Path parameters

postIdstringrequired

The post_ id.

commentIdstringrequired

The cmt_ id.

Query parameters

accountIdstringrequired

The account (acc_...) the post or conversation belongs to.

curl -X DELETE "https://creatoros-production-5658.up.railway.app/v1/inbox/comments/post_3JSJJWvgHKZH-Vjy_ggeP792GJbvjQ1pZzbqlPEgKJOO/cmt_Lr5Tz8Qk2Wx7Ny4Bv1Hm9Jc6Pd3Fs0Ga8Ue5Ki2Oq7X?accountId=acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "success": true
}
PreviousAnalyticsNextDirect messages