Skip to main content
GET
Get post comments

Request contract

  • Method and path: GET /apis/v1/social/inbox/comments/{postId}
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/social/inbox/comments/{postId}
  • postId: path; required
  • accountId: query; required
  • subreddit: query; optional
  • limit: query; optional
  • cursor: query; optional
  • commentId: query; optional
  • Runtime facts: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

postId
string
required

AIsa post ID or platform-specific post ID. AIsa IDs are auto-resolved.

  • LinkedIn: pass the post id exactly as the feed returns it (urn:li:share: or urn:li:ugcPost:). A bare number is read as an activity id (urn:li:activity:, the number in a linkedin.com/feed/update URL), so a share or ugcPost number passed bare returns an empty list.
  • Facebook: a comment ID is also accepted and returns that comment's replies (kept for backwards compatibility). Prefer the commentId query parameter, which also works on Instagram.

Query Parameters

accountId
string
required

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$
subreddit
string

(Reddit only) Subreddit name

limit
integer
default:25

Maximum number of comments to return

Required range: 1 <= x <= 100
cursor
string

Pagination cursor, returned by a previous call as pagination.cursor. This is the platform's own opaque paging value passed through verbatim: never construct, decode or validate it client-side.

commentId
string

(Facebook, Instagram, Reddit and TikTok) Get replies to a specific comment. On Facebook and Instagram, the requested comment is returned in the top-level comment field and comments[] holds its replies.

Response

Comments for the post

comment
object

(Facebook and Instagram only) Present when commentId was passed: the requested comment itself, in the same shape as an entry in comments[]. comments[] then holds that comment's replies instead of the post's top-level comments.

comments
object[]
meta
object
pagination
object
post
object

(Reddit, Facebook and Instagram) Metadata for the target post, returned with the comments so you can render a preview without another request.

Facebook and Instagram return the Meta shape: post thumbnail, text and permalink, for any post the account can read, including hidden dark posts Meta publishes per ad variant (dynamic creative, placement asset customization, Advantage+).

  • Facebook posts need the Facebook Page connection; Instagram media the Instagram connection.
  • thumbnailUrl and mediaUrl are expiring Meta CDN URLs: store a copy to render them later.
  • On Instagram, productType tells an ad (AD) from organic media (FEED, REELS, STORY).

Absent on other platforms, when the connection's token cannot read the post, and on Reddit when the upstream response lacks the post listing (deleted post, malformed response).

status
string