List comments · Adeli API

curl --fail-with-body "https://app.tryadeli.com/api/v1/comments?platform=tiktok&accountId=00000000-0000-0000-0000-000000000000&postId=7300000000000000000" \ -H "Authorization: Bearer $ADELI_API_KEY"

{ "platform": "tiktok", "accountId": "00000000-0000-0000-0000-000000000000", "profileId": "00000000-0000-4000-8000-000000000001", "postId": "7300000000000000000", "posts": [ { "id": "7300000000000000000", "caption": "Backyard birds", "thumbnailUrl": "https://...", "permalink": "https://www.tiktok.com/@creator/video/7300000000000000000", "publishedAt": "2026-09-30T12:00:00.000Z", "commentsCount": 2 } ], "comments": [ { "id": "7301000000000000001", "mediaId": "7300000000000000000", "parentId": null, "authorName": "Bird Fan", "authorFullName": "Bird Fan", "authorHandle": "birdfan", "avatarUrl": "https://...", "profileUrl": "https://www.tiktok.com/@birdfan", "body": "What a cardinal!", "likeCount": 3, "isCreator": false, "isHidden": false, "createdAt": "2026-09-30T13:00:00.000Z", "liked": false, "deletable": false }, { "id": "7301000000000000002", "mediaId": "7300000000000000000", "parentId": "7301000000000000001", "authorName": "Creator", "authorFullName": "Creator", "authorHandle": "creator", "avatarUrl": null, "profileUrl": "https://www.tiktok.com/@creator", "body": "Thank you!", "likeCount": 0, "isCreator": true, "isHidden": false, "createdAt": "2026-09-30T13:05:00.000Z", "liked": false, "deletable": true } ], "nextCursor": "30", "complete": false, "syncedAt": "2026-09-30T13:06:00.000Z" }

Returns the account's recent posts and the comments on one of them — the post named by postId, or the newest post when it is omitted. Replies are returned alongside top-level comments and carry parentId. Comments are newest first.

posts holds the account's newest 25 posts on Instagram and Facebook, and its newest 20 on TikTok, and its newest 25 videos on YouTube. postId may name an older post of the account's too.

YouTube sends no notice of new comments. While you keep reading a channel's comments, Adeli checks the channel's newest comments across every video at most every two minutes, and re-reads only the videos that have new ones.

The first time a post is read, Adeli fetches its newest comments from the platform while you wait and the rest in the background, so that response has complete: false. Read again a few seconds later for the remainder.

Query parameters

platform"instagram" | "facebook" | "tiktok" | "youtube"Required
accountIduuidRequired: A connected account on that platform.
profileIduuid: Optional, because accountId names its profile. If you pass both, they must agree.
postIdstring: One of the account's posts. Defaults to the newest.
cursorstring: TikTok and YouTube only: the nextCursor of the previous page.

Comment fields

isCreatorboolean: Written by the connected account itself.
isHiddenboolean: Hidden from everyone but its author. On YouTube, held for review or flagged as likely spam: visible only to the channel.
likedboolean: TikTok only: the connected account has liked it.
deletableboolean: TikTok and YouTube: false for comments TikTok will not delete. Always true on YouTube, where any comment can be removed.
replyCountnumber: TikTok and YouTube: how many replies the platform reports for the comment, which can exceed the replies returned so far.
nextCursorstring | null: TikTok and YouTube: pass as cursor for the next page of comments, fetched live from the platform. Null once every thread is held, and always null on Instagram and Facebook.
completeboolean: Whether every top-level comment on the post is held. False on a post's first read, and on a TikTok post Adeli has read only the newest page of.
syncedAtstring | null: When these comments were last refreshed from the platform.

On TikTok each page holds up to 30 top-level comments. TikTok returns three replies per thread inline; Adeli fetches the rest of a few threads with each background refresh, so replyCount can briefly exceed the replies returned. A cursor request is the exception to reading from Adeli's copy: it is fetched from TikTok while you wait, and returns that page alone.

On YouTube each page holds up to 100 top-level comments, and YouTube returns up to five replies per thread inline. cursor works the same way as on TikTok.

Errors — 401 unauthorized, 400 invalid_request, 404 account_not_found, 404 post_not_found, 404 profile_not_found, 409 page_not_selected, 422 connection_expired, 422 not_supported, 429 rate_limited, 429 quota_exhausted, 502 provider_error.