List reviews
Company or product reviews from the Timeline with rating, text, reviewer, source, tags and replies.
GET https://cotlet.dev/api/v1/reviews-io/reviews
read
Returns reviews as the Timeline shows them; type picks company or product reviews. Each review carries its replies, so an empty replies list means nobody answered. source says where the review came from, for example reviews_io, google or trustpilot. search matches the reviewer name or email address. Pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| type enum | enum | company or product. Default: company. |
| search string | string | Reviewer name or email address. |
| rating_min integer | integer | Lowest star rating, 1 to 5. |
| rating_max integer | integer | Highest star rating, 1 to 5. |
| date_from date | date | Only reviews on or after this date. |
| date_to date | date | Only reviews on or before this date. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/reviews-io/reviews \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("reviews-io", "list_reviews")const result = await cotlet.call('reviews-io', 'list_reviews');cotlet call reviews-io list_reviewsExample response
{
"reviews": [
{
"review_id": "4831902",
"type": "company",
"rating": 5,
"reviewer": "Hannah Weiss",
"source": "reviews_io",
"created_at": "2026-10-21",
"text": "Kettle arrived on time and boils fast.",
"tags": [
"kettle"
],
"replies": []
},
{
"review_id": "4829417",
"type": "company",
"rating": 1,
"reviewer": "Sam Cole",
"source": "reviews_io",
"created_at": "2026-10-20",
"text": "Visit my-shop-deals.example for coupons.",
"tags": [],
"replies": []
}
],
"next_cursor": "c2"
}