List Reviews

The Reviews API reads and replies to customer reviews. It is available for meta (Facebook Page ratings) and google_business. Reviews are fetched live from the platform per account.

Platforms without review support are simply skipped in the list and return 403 { "error": "not_supported", "capability": "reviews" } on reply.

GET/v1/reviews

Query parameters

Query	Notes
`profile_id`	Only review-capable accounts in this profile
`account_id`	A single account
`platform`	`meta` or `google_business`
`min_rating`	Only reviews at or above this rating

{
  "reviews": [
    { "id": "rev_ext_1", "rating": 5, "text": "Great!", "author": "Sam", "platform": "google_business", "account_id": "sa_..." }
  ]
}

Reply to a Review

POST/v1/reviews/:id/reply

:id is the platform-side review id. Pass the account_id that owns the review.

POST /v1/reviews/:id/reply

curl -X POST https://api.socialit.com/v1/reviews/REVIEW_ID/reply \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "account_id": "sa_...", "message": "Thank you!" }'

{
  "ok": true
}

Delete Review Reply

DELETE/v1/reviews/:id/reply

Supported on google_business. Pass account_id as a query parameter.

{
  "ok": true
}