Skip to content
reelspanDocs

Engage

Comments

Read, write, reply to, moderate and delete comments under your posts, in one shape for every network that has comments in its API.

GETapi.reelspan.com/v1/commentsTry it →

Comments under a profile's posts look the same whichever network they are on: an id, the text, created_at, the author and a parent_id for replies. Read them, answer them in public or with a private message, hide, like or approve them, and delete them.

Reading needs a key with the read scope; everything that writes needs publish.

Name the post

Every call names the network (platform), the profile (user, or profile_username) and the post, in one of three ways:

Field
request_id The Reelspan request that published it. The easiest when you posted it through Reelspan.
post_id The network's own id for the post, for any post of the account.
post_url The post's link (Instagram and Bluesky).

List comments

curl "https://api.reelspan.com/v1/comments?platform=instagram&user=my-brand&request_id=9b1f6c2e8a3d4f50b7e1c9a2d6f3e8b1" \
  -H "Authorization: Bearer $REELSPAN_API_KEY"
{
  "success": true,
  "platform": "instagram",
  "comments": [
    {
      "id": "17998765432109876",
      "text": "Where can I buy this?",
      "created_at": "2026-12-01T09:12:03.000Z",
      "author": { "id": "17841400000000000", "username": "a_fan" },
      "parent_id": null,
      "like_count": 2,
      "reply_count": 0
    }
  ],
  "pagination": { "next_cursor": "QVFIUm…", "has_next": true },
  "cached": false
}
  • Newest first where the network can sort. limit is 1 to 100 (default 25); pass pagination.next_cursor as cursor for the next page.
  • comment_id lists the replies to that comment instead.
  • Some networks add their own keys to a comment, such as like_count, reply_count or a Google review's star rating.
  • On X, leaving out the post lists the account's mentions. On Google Business, the comments are the location's reviews.
  • YouTube: held=true lists only the comments held for review; approve them with the approve action.
  • Lists are kept for a minute. Anything you write through Reelspan on that account clears it; cached says whether this answer came from it.

Comment or reply

curl -X POST https://api.reelspan.com/v1/comments \
  -H "Authorization: Bearer $REELSPAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform": "youtube", "user": "my-brand", "post_id": "dQw4w9WgXcQ", "message": "Thanks for watching!"}'
{ "success": true, "platform": "youtube", "id": "Ugz…", "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ&lc=Ugz…" }

POST /v1/comments comments on the post, or replies to comment_id when you send one. POST /v1/comments/public-reply is the same reply with comment_id and message required. On Facebook, attachment_url adds an image under the comment. To post a comment the moment a post goes live, use first_comment on the publish endpoints instead.

Answer privately

POST /v1/comments/reply sends the comment's author a direct message, linked to their comment. Instagram (comments under 7 days old, one private reply per comment) and Facebook. Up to 3 link buttons.

curl -X POST https://api.reelspan.com/v1/comments/reply \
  -H "Authorization: Bearer $REELSPAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "instagram",
    "user": "my-brand",
    "comment_id": "17998765432109876",
    "message": "Here is the link you asked for",
    "buttons": [{ "title": "Shop now", "url": "https://example.com/shop" }]
  }'
{ "success": true, "recipient_id": "17841400000000000", "message_id": "aWdfZAG1…" }

To answer every matching comment on a post automatically, start an AutoDM monitor.

Moderate

POST /v1/comments/action with an action and the comment_id. edit takes the new text in message; enable_comments and disable_comments need only the post.

curl -X POST https://api.reelspan.com/v1/comments/action \
  -H "Authorization: Bearer $REELSPAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform": "instagram", "user": "my-brand", "comment_id": "17998765432109876", "action": "hide"}'

Each network allows its own actions:

Network Actions
Instagram hide, unhide, enable_comments, disable_comments
Facebook hide, unhide, like, unlike, edit
YouTube hide, unhide, approve, hold, ban_author, edit
Threads hide, unhide, approve, ignore
X hide, unhide, like, unlike
Bluesky like
Mastodon like, unlike
Reddit like, unlike, approve, hide
WordPress approve, hold, hide, unhide, edit

An action the network doesn't allow gets 400 action_not_supported, with the ones it does in supported_actions.

Delete

DELETE /v1/comments (or POST /v1/comments/delete) with the comment_id. Your own comments anywhere; on Instagram, Facebook and YouTube, any comment on your posts. LinkedIn needs the post too. On Google Business it deletes your reply to a review.

await reelspan.comments.delete({ platform: 'facebook', user: 'my-brand', commentId: '1234567890_987654321' });

Which networks

Comments can be read on Instagram, Facebook, YouTube, Threads, LinkedIn, X, Bluesky, Mastodon, Reddit, WordPress, Slack (a message's thread), Google Business (reviews), Dev.to and Hashnode. Writing and deleting follow what each network's API allows; Dev.to's, for one, only reads. A network without comments in its API gets 400 platform_not_supported, with the networks that have them in supported_platforms.

Some of this needs a permission beyond publishing, such as instagram_manage_comments on Instagram. An account connected before Reelspan asked for it gets 409 permission_reconnect: reconnect it and allow the permission. See Permissions.

Errors

Status error_code When
400 platform_not_supported, action_not_supported, invalid_post_id, text_required The network can't do this, or the request is incomplete.
403 The account hasn't granted a permission this needs.
404 profile_platform_mapping_invalid, POST_NOT_FOUND, NOT_FOUND, POST_DELETED No such account, post or comment. POST_DELETED: the post was deleted on the network, outside Reelspan, and is now marked deleted.
409 reauth_required, permission_reconnect Reconnect the account.
502 The network's code The network refused; retryable says whether trying again may work.

New comments can also come to you: subscribe to the comment_received webhook.

GETapi.reelspan.com/v1/commentsTry it →

Parameters

  • platformstring · queryrequired

    The network

  • userstring · query

    Profile username (also profile_username)

  • profile_usernamestring · query
  • post_idstring · query

    The network’s post id

  • post_urlstring · query

    Or the post’s link (Instagram, Bluesky)

  • request_idstring · query

    Or the Reelspan request that published it

  • comment_idstring · query

    List the replies to this comment

  • heldstring · query

    YouTube: only the comments held for review (approve them with the approve action)

    truefalse

  • limitinteger · query
  • cursorstring · query

    next_cursor from the previous page (also after)

  • afterstring · query

Responses

200 Comments

{
  "success": true,
  "platform": "string",
  "comments": [
    {
      "id": "string",
      "text": "string",
      "created_at": "string",
      "author": {
        "id": "string",
        "username": "string"
      },
      "parent_id": "string"
    }
  ],
  "pagination": {
    "next_cursor": "string",
    "has_next": true
  },
  "cached": true
}

400 Invalid input, or the network can’t do this (`platform_not_supported`, `action_not_supported`)

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}

403 The connected account hasn’t granted a permission this needs: reconnect it and allow it

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}
POSTapi.reelspan.com/v1/commentsTry it →

Request body

application/json

  • platformstringrequired

    The network

  • userstring

    Profile username (also profile_username)

  • profile_usernamestring
  • post_idstring

    The network’s post id

  • post_urlstring

    Or the post’s link (Instagram, Bluesky)

  • request_idstring

    Or the Reelspan request that published it

  • messagestring

    The comment (also text)

  • textstring
  • comment_idstring

    Reply to this comment instead of commenting on the post

  • attachment_urlstring

    Facebook: an image under the comment

Responses

200 Posted

{
  "success": true,
  "platform": "string",
  "id": "string",
  "url": "string"
}

400 Invalid input, or the network can’t do this (`platform_not_supported`, `action_not_supported`)

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}

403 The connected account hasn’t granted a permission this needs: reconnect it and allow it

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}
POSTapi.reelspan.com/v1/comments/public-replyTry it →

Request body

application/json

  • platformstringrequired

    The network

  • userstring

    Profile username (also profile_username)

  • profile_usernamestring
  • post_idstring

    The network’s post id

  • post_urlstring

    Or the post’s link (Instagram, Bluesky)

  • request_idstring

    Or the Reelspan request that published it

  • comment_idstringrequired
  • messagestringrequired

Responses

200 Posted

{
  "success": true,
  "id": "string"
}

400 Invalid input, or the network can’t do this (`platform_not_supported`, `action_not_supported`)

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}

403 The connected account hasn’t granted a permission this needs: reconnect it and allow it

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}
POSTapi.reelspan.com/v1/comments/replyTry it →

Request body

application/json

  • platformstringrequired

    The network

  • userstring

    Profile username (also profile_username)

  • profile_usernamestring
  • comment_idstringrequired
  • messagestringrequired
  • buttonsobject[]
    • titlestringrequired
    • urlstringrequired

Responses

200 Sent

{
  "success": true,
  "recipient_id": "string",
  "message_id": "string"
}

400 Invalid input, or the network can’t do this (`platform_not_supported`, `action_not_supported`)

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}

403 The connected account hasn’t granted a permission this needs: reconnect it and allow it

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}
POSTapi.reelspan.com/v1/comments/actionTry it →

Request body

application/json

  • platformstringrequired

    The network

  • userstring

    Profile username (also profile_username)

  • profile_usernamestring
  • post_idstring

    The network’s post id

  • post_urlstring

    Or the post’s link (Instagram, Bluesky)

  • request_idstring

    Or the Reelspan request that published it

  • comment_idstring

    Not needed for enable_comments/disable_comments

  • actionstringrequired

    hideunhidelikeunlikeapproveignoreholdban_authoreditenable_commentsdisable_comments

  • messagestring

    The new text, for edit

Responses

200 Done

{
  "success": true,
  "action": "string"
}

400 Invalid input, or the network can’t do this (`platform_not_supported`, `action_not_supported`)

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}

403 The connected account hasn’t granted a permission this needs: reconnect it and allow it

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}
DELETEapi.reelspan.com/v1/commentsTry it →

Request body

application/json

  • platformstringrequired

    The network

  • userstring

    Profile username (also profile_username)

  • profile_usernamestring
  • post_idstring

    The network’s post id

  • post_urlstring

    Or the post’s link (Instagram, Bluesky)

  • request_idstring

    Or the Reelspan request that published it

  • comment_idstringrequired

Responses

200 Deleted

{
  "success": true
}

400 Invalid input, or the network can’t do this (`platform_not_supported`, `action_not_supported`)

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}

403 The connected account hasn’t granted a permission this needs: reconnect it and allow it

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}

Something unclear or missing? Write to [email protected] and we’ll fix the page.