List reviews

List reviews from Review Inbox with their status.

GET https://cotlet.dev/api/v1/brightlocal/reviews

read

Returns the date, source, rating, review text and status of each review, newest first. can_respond is true only for Google and Facebook reviews of a location connected to Reputation Manager; for other sites BrightLocal offers a link to the listing.

Parameters

Parameters: list_reviews
NameTypeDescription
location_id string string Only reviews of this location.
source string string Review site, for example Google, Facebook or Yelp.
status string string Unread, Action Required, Do Not Respond, Manually Responded, Auto-Responded, Pending Removal, Successfully Removed or Removal Failed.
rating integer integer Only reviews with this star rating.
since string string ISO date; only reviews from this day on.
cursor string string Next page cursor from the previous call.

Request

cURL
curl https://cotlet.dev/api/v1/brightlocal/reviews \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("brightlocal", "list_reviews")
Node.js
const result = await cotlet.call('brightlocal', 'list_reviews');
CLI
cotlet call brightlocal list_reviews

Example response

JSON

{
  "reviews": [
    {
      "review_id": "rv_91c2",
      "location": "Harbor Dental, Austin",
      "source": "Google",
      "rating": 5,
      "date": "2026-10-21",
      "author": "Dana R.",
      "text": "Dr. Lee made my whitening visit painless. Booking was easy too.",
      "status": "Unread",
      "can_respond": true
    },
    {
      "review_id": "rv_77d4",
      "location": "Harbor Dental, Austin",
      "source": "Yelp",
      "rating": 2,
      "date": "2026-10-20",
      "author": "Sam T.",
      "text": "Waited 40 minutes past my appointment time.",
      "status": "Unread",
      "can_respond": false
    }
  ],
  "next_cursor": null
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.