Search, list comments of a content including like count, author information and replies.
List Comments
GET/api/v1/comment/comments.list
Returns a paginated list of comments, ordered by newest first. At least one filter is required to scope the query.
Filter by content_id (a content id) to retrieve the comments on a piece of content, by id to retrieve a single comment, or by parent_comment_id to retrieve the replies to a comment. A request that supplies none of these returns INVALID_ID.
Parameters
order_byType: enum[]unique items true
Sort by like_count. A bare key sorts descending.
Sort direction is inverted:order_by=field sorts descending and order_by=-field sorts ascending. Comma-separate to sort by multiple fields.
Show values
unique items
true
like_count-like_count
content_idType: string
Id of the content to list comments for.
idType: string
Id of a single comment to fetch.
is_parent_commentType: boolean
True to only top-level comments, false to only replies.
parent_comment_idType: string
Id of the parent comment to list replies for.
Returns Comment
idType: stringread-only
Unique identifier for the comment.
textType: string
The comment's text content.
platformType: stringor null
The platform the comment was posted on: instagram, tiktok or youtube.
like_countType: integeror null
Number of likes the comment has received.
posted_atType: string(date-time)or null
Time the comment was posted on its platform (UTC).
content_idType: stringor nullread-only
Identifier of the content the comment was left on.
parent_comment_idType: stringor nullread-only
Identifier of the comment this is a reply to. Null for top-level comments.
is_parent_commentType: booleanread-only
Whether this is a top-level comment, rather than a reply to another comment.
authorType: CommentAuthorread-only
The creator who wrote the comment. Null when the author is unknown.
Show child attributes
author.idType: stringread-only
Unique identifier for the author.
author.usernameType: stringor null
The author's username or handle on the platform (without the leading @).
from zelf import ZelfAPIClient
client = ZelfAPIClient(api_key="<your-api-key>")
result = client.comments.list()
print(result)
Response
{"log_id":"3fa85f64-5717-4562-b3fc-2c963f66afa6","timestamp":"2026-01-01T00:00:00Z","results":[{"id":"com_tfBrrZrU2Kp5VTsW","text":"Love what Zelf is building!","platform":"instagram","like_count":312,"posted_at":"2026-05-12T16:00:00Z","content_id":"con_DZaWwnKo5HThZ9bu","parent_comment_id":null,"is_parent_comment":true,"author":{"id":"cr_bxUfTmtAcXdlHwKO","username":"zelfai","name":"Zelf","profile_picture_url":"https://cdn.hellozelf.com/avatars/zelfai.png"}}],"item_count":1,"page":1,"next":null,"previous":null}
List Comments
/api/v1/comment/comments.listReturns a paginated list of comments, ordered by newest first. At least one filter is required to scope the query.
Filter by
content_id(a contentid) to retrieve the comments on a piece of content, byidto retrieve a single comment, or byparent_comment_idto retrieve the replies to a comment. A request that supplies none of these returnsINVALID_ID.Parameters
order_by Type: enum[]unique items trueSort by
like_count. A bare key sorts descending.Sort direction is inverted:
order_by=fieldsorts descending andorder_by=-fieldsorts ascending. Comma-separate to sort by multiple fields.like_count-like_countcontent_id Type: stringId of the content to list comments for.
idType: stringId of a single comment to fetch.
is_parent_comment Type: booleanTrue to only top-level comments, false to only replies.
parent_comment_id Type: stringId of the parent comment to list replies for.
Returns Comment
idType: stringread-onlyUnique identifier for the comment.
textType: stringThe comment's text content.
platformType: stringor nullThe platform the comment was posted on:
instagram,tiktokoryoutube.like_count Type: integeror nullNumber of likes the comment has received.
posted_at Type: string(date-time)or nullTime the comment was posted on its platform (UTC).
content_id Type: stringor nullread-onlyIdentifier of the content the comment was left on.
parent_comment_id Type: stringor nullread-onlyIdentifier of the comment this is a reply to. Null for top-level comments.
is_parent_comment Type: booleanread-onlyWhether this is a top-level comment, rather than a reply to another comment.
authorType: CommentAuthorread-onlyThe creator who wrote the comment. Null when the author is unknown.
author.idType: stringread-onlyUnique identifier for the author.
author.usernameType: stringor nullThe author's username or handle on the platform (without the leading
@).author.nameType: stringor nullThe author's display name on the platform.
author.profile_picture_url Type: stringor nullread-onlyURL of the author's profile picture.
Responses
Comment
idType: stringread-onlyUnique identifier for the comment.
textType: stringThe comment's text content.
platformType: stringor nullThe platform the comment was posted on:
instagram,tiktokoryoutube.like_count Type: integeror nullNumber of likes the comment has received.
posted_at Type: string(date-time)or nullTime the comment was posted on its platform (UTC).
content_id Type: stringor nullread-onlyIdentifier of the content the comment was left on.
parent_comment_id Type: stringor nullread-onlyIdentifier of the comment this is a reply to. Null for top-level comments.
is_parent_comment Type: booleanread-onlyWhether this is a top-level comment, rather than a reply to another comment.
authorType: CommentAuthorread-onlyThe creator who wrote the comment. Null when the author is unknown.
author.idType: stringread-onlyUnique identifier for the author.
author.usernameType: stringor nullThe author's username or handle on the platform (without the leading
@).author.nameType: stringor nullThe author's display name on the platform.
author.profile_picture_url Type: stringor nullread-onlyURL of the author's profile picture.
Request
from zelf import ZelfAPIClient client = ZelfAPIClient(api_key="<your-api-key>") result = client.comments.list() print(result){ "log_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "timestamp": "2026-01-01T00:00:00Z", "results": [ { "id": "com_tfBrrZrU2Kp5VTsW", "text": "Love what Zelf is building!", "platform": "instagram", "like_count": 312, "posted_at": "2026-05-12T16:00:00Z", "content_id": "con_DZaWwnKo5HThZ9bu", "parent_comment_id": null, "is_parent_comment": true, "author": { "id": "cr_bxUfTmtAcXdlHwKO", "username": "zelfai", "name": "Zelf", "profile_picture_url": "https://cdn.hellozelf.com/avatars/zelfai.png" } } ], "item_count": 1, "page": 1, "next": null, "previous": null }