---
title: "Recent comments"
method: GET
path: "/v1/comments"
---

# Recent comments

`GET /v1/comments`

## Request

- Base URL: `https://api.breakreach.com`
- URL: `https://api.breakreach.com/v1/comments`
- Auth: HTTP bearer

Comments on the latest 10 posts of every connected Instagram, Facebook and Threads account, including posts not published with Breakreach, plus replies to X posts published with Breakreach, plus the latest 50 reviews of every Google Business Profile location (platform googlebusiness, each review a comment with its rating and the business's reply nested under it). Newest first. Each comment carries the accountId and platform needed to reply. Google only shows reviews of verified locations: an unverified one is listed in errors. YouTube is not listed yet: its comments need a restricted Google permission (youtube.force-ssl) that is not available to every account.

## Query parameters

- `platform` 'instagram' | 'facebook' | 'threads' | 'x' | 'googlebusiness'
- `accountId` string
- `workspace` string

## Response `200`

OK

- object
  - `comments` Comment[]
    - `id` string: Pass as commentId to reply or delete. For a Google review, the review id
    - `platform` string
    - `postId` string: The platform post id, or the Google location (accounts/{a}/locations/{l})
    - `text` string: Empty for a Google review with stars only
    - `username` string
    - `avatarUrl` string, uri
    - `timestamp` string, date-time
    - `likeCount` number
    - `hidden` boolean
    - `rating` integer: Google reviews: the star rating
    - `status` 'pending' | 'approved' | 'rejected': The business's reply to a Google review: Google's moderation status
    - `policyViolation` string: Why Google rejected the reply, e.g. HARASSMENT
    - `replies` Comment[]
    - `postContent` string
    - `postUrl` string, uri
    - `postImage` string, uri
    - `accountId` string
    - `accountDisplayName` string
  - `errors` object[]: Accounts that couldn't be read, with the reason; reconnect is true when reconnecting the account fixes it
    - `accountId` string
    - `platform` string
    - `displayName` string
    - `error` string
    - `reconnect` boolean
  - `ratings` object[]: Each Google Business Profile location's score
    - `accountId` string
    - `accountDisplayName` string
    - `averageRating` number, nullable
    - `totalReviewCount` integer

## Other responses

- `400`: Unsupported platform or invalid accountId
- `401`: Missing, invalid or expired API key
- `402`: No active Breakreach subscription or trial
- `403`: Not a member of the requested workspace
- `404`: Workspace not found

---

[API](https://skmtc.dev/breakreach/apis/breakreach-api.md) · [All operations](https://skmtc.dev/breakreach/apis/breakreach-api/llms.txt) · [OpenAPI document](https://skmtc.dev/breakreach/apis/breakreach-api/revisions/290d285f8d73?raw)