List reviews

Fetches reviews across connected accounts via real-time fan-out to platform APIs. Supports filtering by account and platform. Reviews are proxied live and not stored — results may vary based on platform availability. Currently only Google Business Profile returns reviews.

GET /inbox/reviews

List reviews

cURL

curl --request GET \
  --url https://api.social-api.ai/v1/inbox/reviews \
  --header 'Authorization: <api-key>'

200

{
  "data": [
    {
      "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
      "author": "John D.",
      "created_at": "2026-03-20T09:00:00Z",
      "id": "AbCdEf123456",
      "platform": "google",
      "rating": 4,
      "text": "Great service, very responsive team!"
    }
  ],
  "meta": {}
}

Authorizations

Authorization · string · header · required

Prefix your API key with "Bearer ". Example: Authorization: Bearer sapi_key_...

Query Parameters

account_id · string

Filter by connected account ID

platform · string

Filter by platform (google)

since · string

Only return reviews created after this timestamp (RFC3339)

limit · integer

Maximum number of results (1-100, default 50)

cursor · string

Pagination cursor from previous response

Response

200

application/json

Reviews with fan-out metadata

data · object[]

Show child attributes

meta · object

Show child attributes