v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Comments

List commented posts

Returns posts with comment counts from all connected accounts. Aggregates data across multiple accounts.

For users with the Ads add-on (Metronome plans always qualify), the user's Meta ads (boosted/dark posts) are included too. There's one row per (ad, placement-with-comments): an ad that runs on both Facebook feed and Instagram feed produces up to two rows (the Page dark post and the IG media have separate comment threads), each flagged isAd: true with adId and placement (id is {adId}:{placement}). Use ?platform=metaads to return only ad rows; passing facebook/instagram returns organic posts only (no ads); omitting platform returns both. Fetch a row's thread from GET /v1/ads/{adId}/comments?placement={placement}. Ad comment counts are read with the Marketing API token (Facebook side) or the connected Instagram account's token (Instagram side); a row whose count can't be read is omitted.

Pagination walks each account's platform listing. Following nextCursor reaches past the first page on Facebook and Instagram only, since they are the platforms that support a server-side date window; on the others the listing stops at its first page.

get/v1/inbox/comments

Query parameters

profileIdstring

Filter by profile ID

platform'facebook' | 'instagram' | 'twitter' | 'bluesky' | 'threads' | 'youtube' | 'linkedin' | 'reddit' | 'metaads'

Filter by platform. metaads is a synthetic value meaning the user's ads (boosted/dark posts) only; facebook/instagram return organic posts only.

minCommentsinteger

Minimum comment count

sincestring date-time

Posts created after this date

sortBy'date' | 'comments'

Sort field

sortOrder'asc' | 'desc'

Sort order

limitinteger
cursorstring
accountIdstring

Filter by specific social account ID

Response

Aggregated posts with comments