List reviews
Reviews from Manage Reviews with status, rating, product, reviewer, flags and days left before auto-publish.
GET https://cotlet.dev/api/v1/yotpo/reviews
read
Lists reviews as Manage Reviews shows them. Reviews scheduled to auto-publish come first unless you pass sort. status uses Yotpo's labels and rating, product and search filter the same way the screen does; product accepts a name, ID, UPC, MPN or SKU. days_to_auto_publish is the countdown Yotpo shows, and flags lists profanity and negative sentiment (sentiment analysis covers English reviews only). comments is the number of replies on the review. get_review returns the full text.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | pending, published, hidden, flagged_for_profanity, escalated or pending_media. Default: all. |
| rating integer | integer | Only reviews with this star rating. |
| product string | string | Product name, ID, UPC, MPN or SKU. |
| search string | string | Words in the review or the shopper's email address. |
| since date | date | Only reviews submitted on or after this date. |
| sort enum | enum | newest, oldest, highest_rating, lowest_rating or with_media. |
| limit integer | integer | Reviews per call. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/yotpo/reviews \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("yotpo", "list_reviews")const result = await cotlet.call('yotpo', 'list_reviews');cotlet call yotpo list_reviewsExample response
{
"reviews": [
{
"review_id": "412873702",
"status": "pending",
"rating": 5,
"title": "Fits true to size",
"product": {
"name": "Trail Runner Shoe",
"sku": "TR-100"
},
"reviewer_name": "Dana P.",
"submitted_at": "2026-10-21T09:12:00Z",
"days_to_auto_publish": 12,
"flags": [],
"escalated": false,
"has_media": false,
"comments": 0
},
{
"review_id": "412873655",
"status": "pending",
"rating": 2,
"title": "Arrived three weeks late",
"product": {
"name": "Trail Runner Shoe",
"sku": "TR-100"
},
"reviewer_name": "Sam O.",
"submitted_at": "2026-10-14T16:40:00Z",
"days_to_auto_publish": 5,
"flags": [
"negative_sentiment"
],
"escalated": false,
"has_media": false,
"comments": 0
}
],
"next_cursor": null
}