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"import { Reelspan } from 'reelspan';
const reelspan = new Reelspan();
const { comments } = await reelspan.comments.list({ platform: 'instagram', user: 'my-brand', requestId: '9b1f6c2e8a3d4f50b7e1c9a2d6f3e8b1' });
// or every comment, page by page
for await (const c of reelspan.comments.all({ platform: 'youtube', user: 'my-brand', postId: 'dQw4w9WgXcQ' })) console.log(c.text);from reelspan import Reelspan
reelspan = Reelspan()
comments = reelspan.comments.list("instagram", "my-brand", request_id="9b1f6c2e8a3d4f50b7e1c9a2d6f3e8b1")["comments"]{
"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.
limitis 1 to 100 (default 25); passpagination.next_cursorascursorfor the next page. comment_idlists the replies to that comment instead.- Some networks add their own keys to a comment, such as
like_count,reply_countor 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=truelists only the comments held for review; approve them with theapproveaction. - Lists are kept for a minute. Anything you write through Reelspan on that account clears it;
cachedsays 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!"}'const { id } = await reelspan.comments.create({ platform: 'youtube', user: 'my-brand', postId: 'dQw4w9WgXcQ', message: 'Thanks for watching!' });
await reelspan.comments.reply({ platform: 'youtube', user: 'my-brand', postId: 'dQw4w9WgXcQ', commentId: 'Ugx…', message: 'Glad you liked it' });reelspan.comments.create("youtube", "my-brand", "Thanks for watching!", "dQw4w9WgXcQ")
reelspan.comments.reply("youtube", "my-brand", "Ugx…", "Glad you liked it", "dQw4w9WgXcQ"){ "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" }]
}'await reelspan.comments.privateReply({ platform: 'instagram', user: 'my-brand', commentId: '17998765432109876', message: 'Here is the link you asked for', buttons: [{ title: 'Shop now', url: 'https://example.com/shop' }] });reelspan.comments.private_reply("instagram", "my-brand", "17998765432109876", "Here is the link you asked for", [{"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"}'await reelspan.comments.moderate({ platform: 'instagram', user: 'my-brand', commentId: '17998765432109876', action: 'hide' });reelspan.comments.moderate("instagram", "my-brand", "hide", "17998765432109876")Each network allows its own actions:
| Network | Actions |
|---|---|
hide, unhide, enable_comments, disable_comments |
|
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 |
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' });reelspan.comments.delete("facebook", "my-brand", "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.