> ## Documentation Index
> Fetch the complete documentation index at: https://mindcase.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# G2 Reviews

> Extract G2.com product reviews with star ratings, review text, and reviewer details from a product URL

`$3.5 / 1k reviews`

Extract G2.com product reviews with star ratings, review text, and reviewer details from a product URL

## Endpoint

`POST /api/v1/agents/g2/reviews/run`

## Parameters

<ParamField body="url" type="string" required>
  **Text** · G2 product or seller page URL. Products: [https://www.g2.com/products/notion/reviews](https://www.g2.com/products/notion/reviews) — Sellers: [https://www.g2.com/sellers/planet-dds](https://www.g2.com/sellers/planet-dds) (aggregates reviews across all vendor products)
</ParamField>

<ParamField body="maxResults" type="integer" default={100}>
  **Number** · Reviews to scrape (max 100,000). Use 0 for all.
</ParamField>

<ParamField body="sortBy" type="string" default="most_recent">
  **Dropdown** · Sort order for reviews.

  **Options:** `most_recent`, `most_helpful`, `lowest_rated`, `highest_rated`

  *Legend: `most_recent` = Most Recent, `most_helpful` = Most Helpful, `lowest_rated` = Lowest Rated, `highest_rated` = Highest Rated*
</ParamField>

<ParamField body="starRatings" type="array" default={[]}>
  **Multi-select** · Filter to reviews with these ratings. Leave empty for all.

  **Options:** `1`, `2`, `3`, `4`, `5`

  *Legend: `1` = 1 Star, `2` = 2 Stars, `3` = 3 Stars, `4` = 4 Stars, `5` = 5 Stars*
</ParamField>

<ParamField body="query" type="string">
  **Text** · A single keyword phrase — only reviews containing all these words. Works only for product URLs.
</ParamField>

## Response columns

| Field                 | Display name          | Type    |
| --------------------- | --------------------- | ------- |
| `product`             | Product               | text    |
| `productSlug`         | Product Slug          | text    |
| `reviewTitle`         | Review Title          | text    |
| `reviewText`          | Review Text           | text    |
| `reviewMarkdown`      | Review (Markdown)     | text    |
| `rating`              | Rating                | rating  |
| `posted`              | Posted                | text    |
| `source`              | Source                | text    |
| `reviewer`            | Reviewer              | text    |
| `reviewerTitle`       | Reviewer Title        | text    |
| `reviewerInfo`        | Reviewer Info         | text    |
| `reviewerInitials`    | Reviewer Initials     | text    |
| `incentivized`        | Incentivized          | boolean |
| `validated`           | Validated             | boolean |
| `verifiedCurrentUser` | Verified Current User | boolean |
| `reviewerAvatar`      | Reviewer Avatar       | url     |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.mindcase.co/api/v1/agents/g2/reviews/run \
    -H "Authorization: Bearer mk_live_abc123def456" \
    -H "Content-Type: application/json" \
    -d '{
    "params": {
      "url": "https://www.g2.com/products/canva/reviews",
      "maxResults": 10,
      "sortBy": "most_recent"
    }
  }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/g2/reviews/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "url": "https://www.g2.com/products/canva/reviews",
      "maxResults": 10,
      "sortBy": "most_recent"
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "product": "Canva",
      "productSlug": "canva",
      "reviewTitle": "Effortless Design with Intuitive Features, But Needs More Advanced Control",
      "reviewText": "I like Canva for its ease of use, which makes editing images and creating designs simple. The drag and drop editor is particularly useful because I can move elements and resize them easily. Additionally, the initial setup was very easy, which allowed me to get started quickly. | It doesn't offer the same level of control as Figma, like alignment control can help a lot.",
      "reviewMarkdown": "# Canva Review: Effortless Design with Intuitive Features, But Needs More Advanced Control\n\n**Rating:** 4.5/5 \u2605\u2605\u2605\u2605\u2606 | **Date:** 2026-05-01\n**Reviewer:** Vineet P. \u2014 Software Engineer\n**Company:** Mid-Market (51-1000 emp.)\n**Status:** Verified (None) | Incentivized\n\n## What I Like\nI like Canva for its ease of use, which makes editing images and creating designs simple. The drag and drop editor is particularly useful because I can move elements and resize them easily. Additionally, the initial setup was very easy, which allowed me to get started quickly.\n\n## What I Dislike\nIt doesn't offer the same level of control as Figma, like alignment control can help a lot.\n\n---\n_reviewId:12728220 | product:canva_",
      "rating": 4.5,
      "posted": "2026-05-01",
      "source": "Organic",
      "reviewer": "Vineet P.",
      "reviewerTitle": "Software Engineer",
      "reviewerInfo": [
        "Mid-Market (51-1000 emp.)"
      ],
      "reviewerInitials": "VP",
      "incentivized": true,
      "validated": true,
      "verifiedCurrentUser": false,
      "reviewerAvatar": "https://lh3.googleusercontent.com/a/ACg8ocIQWNuwwAQgwVAula9YSwwNDCDXIRdM0hDo76g_9jN6GBIUVQ=s96-c"
    }
  ]
}
```