Skip to main content
GET
List comments on a published post
Available on all plans. Use post_id with the Mallary job/post ID returned by the posts API. If that ID belongs to a grouped multi-platform post and you omit platform, Mallary reads every supported platform job in the group. It then returns a combined comment list. The response uses platform: "multiple", and each comment includes its concrete platform and post_id. For platforms that Mallary cannot read, platform_errors can include the read failures. If you want one platform from a grouped post, pass platform. Mallary then routes the request to the matching sibling job in that group. When the platform returns them, Mallary includes own/initial comments. When Mallary identifies the author as the connected account, these comments have is_own: true and can_reply: false. For a LinkedIn Page post, Mallary reads comments for the Page you selected when you connected LinkedIn. A comment can include the person’s name and LinkedIn ID when LinkedIn sends them. LinkedIn may ask you to reconnect once so Mallary can read Page comments.

Authorizations

Authorization
string
header
required

Use Authorization: Bearer {api_key}

Query Parameters

post_id
integer
required

Mallary job/post ID returned by POST /api/v1/post or GET /api/v1/posts.

platform
enum<string>

Optional platform hint. Required only when a stored post cannot be disambiguated from the job record. Platforms that currently support comment listing and reply posting through Mallary.

Available options:
facebook,
instagram,
threads,
linkedin,
x,
twitter,
youtube,
bluesky
profile_id
string

Optional connection profile ID. Omit to use the profile that created the post. Random public connection profile ID returned by GET /api/v1/profiles.

Pattern: ^[A-Za-z0-9]{6,32}$
Example:

"AbC123xYz90"

limit
integer
default:25
Required range: 1 <= x <= 100

Response

Comments retrieved

status
enum<string>
Available options:
ok
data
object
Last modified on September 8, 2026