[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# List reviews

> Reviews from Manage Reviews with status, rating, product, reviewer, flags and days left before auto-publish. Inputs, cURL, Python and Node.js examples and an example response.

Source: https://cotlet.dev/docs/api/yotpo/list_reviews

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

Reviews from Manage Reviews with status, rating, product, reviewer, flags and days left before auto-publish.

Yotpo API: https://cotlet.dev/docs/api/yotpo.md

`GET https://cotlet.dev/api/v1/yotpo/reviews`

Access: 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 | Required | Description |
|---|---|---|---|
| `status` | enum | no | pending, published, hidden, flagged_for_profanity, escalated or pending_media. Default: all. |
| `rating` | integer | no | Only reviews with this star rating. |
| `product` | string | no | Product name, ID, UPC, MPN or SKU. |
| `search` | string | no | Words in the review or the shopper's email address. |
| `since` | date | no | Only reviews submitted on or after this date. |
| `sort` | enum | no | newest, oldest, highest_rating, lowest_rating or with_media. |
| `limit` | integer | no | Reviews per call. |
| `cursor` | string | no | Next page cursor from the previous call. |

## Request

**cURL**

```bash
curl https://cotlet.dev/api/v1/yotpo/reviews \
  -H "Authorization: Bearer $COTLET_API_KEY"
```

**Python**

```python
result = client.call("yotpo", "list_reviews")
```

**Node.js**

```js
const result = await cotlet.call('yotpo', 'list_reviews');
```

**CLI**

```bash
cotlet call yotpo list_reviews
```

## Example response

```json
{
  "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
}
```

Next: [Get a review](https://cotlet.dev/docs/api/yotpo/get_review.md)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.