POpostproxy
Comments

List comments across posts

Retrieves comments spanning many posts and profiles in a single request. The response is flat: every comment, top-level or reply, is its own entry in data, linked to its parent by parent_external_id, ordered by created_at descending.

get/api/comments

Request

  • Base URL
    https://api.postproxy.dev
  • URL
    https://api.postproxy.dev/api/comments
  • Auth
    HTTP bearer

Query parameters

profile_group_idstring

Profile group context for the request. Optional when the API key is scoped to a profile group (that group is used automatically); with a full-access key, defaults to the first profile group in the account.

post_idsstring

Comma-separated post IDs. Omit to include every post in scope. Unknown or out-of-scope IDs are ignored. Passing a thread's parent post also returns comments on that thread's child posts.

profilesstring

Comma-separated profile IDs or network names (e.g. instagram,twitter, abc123,def456, or mixed). Network names are matched against known platforms (facebook, instagram, tiktok, linkedin, youtube, twitter, threads, pinterest, bluesky, telegram); anything else is treated as a profile ID.

fromstring

ISO 8601 date/time — only comments received (created_at) at or after this point. A bare date means that date's start of day.

tostring

ISO 8601 date/time — only comments received (created_at) at or before this point.

pageinteger

Page number (1-based). Passing 0 returns page 1.

per_pageinteger

Number of items per page.

Response

Flat, paginated list of comments across posts. Pagination counts every comment, not just top-level ones.

totalinteger

Total number of matching comments, replies included

pageinteger

Current page number

per_pageinteger

Items per page

Changes

No recorded changes to this operation across all 1 revision of this API.