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

# G2 Reviews API

> Extract G2 software reviews for any product: star rating, title, what the reviewer liked and disliked, full text, reviewer role and company size, newest first

`POST /v1/data/g2/reviews/run`

**Pricing:** $0.004 per review ($4.00 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**products** `string[]` *required*

G2 product review URLs ([https://www.g2.com/products/notion/reviews](https://www.g2.com/products/notion/reviews)) or bare product slugs (notion). One per line.

**maxResults** `integer` (default: 50)

How many reviews to return per product. Defaults to 50; use 0 for all.

**sortBy** `string` (default: newest)

The order G2 lists the reviews in before Max Results is applied. Newest first by default.

Allowed values: `newest` (Newest first), `highest_rated` (Highest rated first), `lowest_rated` (Lowest rated first), `most_helpful` (Most helpful first).

**stars** `string[]`

Only reviews in these G2 star buckets; a bucket holds its half star too (4 stars covers 3.5 and 4). Pick one value, or a run that starts at 1 or ends at 5 (4 and 5 means 4 stars and up). Leave empty for all.

Allowed values: `1` (1 star), `2` (2 stars), `3` (3 stars), `4` (4 stars), `5` (5 stars).

**reviewsNewerThan** `date`

Only reviews published on or after this date (YYYY-MM-DD), up to 10 years back. Reviews then come newest first, so Sort By must be left at Newest first.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/g2/reviews/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "products": [
      "https://www.g2.com/products/notion/reviews",
      "https://www.g2.com/products/pipedrive/reviews",
      "https://www.g2.com/products/zoho-crm/reviews"
    ],
    "maxResults": 2
  }
}'
```

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

r = requests.post(
    "https://api.mindcase.co/v1/data/g2/reviews/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "products": [
        "https://www.g2.com/products/notion/reviews",
        "https://www.g2.com/products/pipedrive/reviews",
        "https://www.g2.com/products/zoho-crm/reviews"
    ],
    "maxResults": 2
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/g2/reviews/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "products": [
    "https://www.g2.com/products/notion/reviews",
    "https://www.g2.com/products/pipedrive/reviews",
    "https://www.g2.com/products/zoho-crm/reviews"
  ],
  "maxResults": 2
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one review, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `reviewId` | Review ID | text |
| `reviewUrl` | Review URL | url |
| `productName` | Product Name | text |
| `productSlug` | Product Slug | text |
| `productId` | Product ID | text |
| `rating` | Rating | rating |
| `reviewTitle` | Review Title | text |
| `postedDate` | Posted Date | text |
| `updatedDate` | Updated Date | text |
| `liked` | Liked | text |
| `disliked` | Disliked | text |
| `reviewText` | Review Text | text |
| `reviewerName` | Reviewer Name | text |
| `reviewSource` | Review Source | text |
| `validatedReviewer` | Validated Reviewer | boolean |
| `incentivized` | Incentivized | boolean |
| `aiTranslated` | AI Translated | boolean |
| `videoReview` | Video Review | boolean |
| `reviewer` | Reviewer | object |
| `questionAnswers` | Question Answers | object |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "g2/reviews",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "reviewId": "7435658",
      "rating": 4.5,
      "reviewTitle": "Quick to learn and valuable for collaborating",
      "productId": "82623",
      "reviewUrl": "https://www.g2.com/products/notion/reviews/notion-review-7435658",
      "reviewerName": "Verified User in Non-Profit Organization Management",
      "validatedReviewer": true,
      "reviewer": {
        "reviewer_id": 53637,
        "reviewer_name": "Verified User in Non-Profit Organization Management",
        "reviewer_job_title": "",
        "business_size": "Mid-Market (51-1000 emp.)"
      },
      "postedDate": "2022-11-28T22:05:47-06:00",
      "updatedDate": "2026-10-30T11:05:03-05:00",
      "videoReview": false,
      "aiTranslated": true,
      "productSlug": "notion",
      "questionAnswers": {
        "What do you like best about Notion?": "Notion is a collaborative cloud-based tool combining the benefits of a database, tables, and word/images/file links. Aside from the ease of collaboration wit...",
        "What do you dislike about Notion?": "Notion can be a bit clunky at first to learn. I suggest taking a quick tutorial before diving in. Although I learned it pretty quickly, there are features I ...",
        "What problems is Notion solving and how is that benefiting you?": "Our teams work remotely, and we are using Notion as a centralized database of all sorts of information. We use this for documentation, sharing progress on pr..."
      },
      "liked": "Notion is a collaborative cloud-based tool combining the benefits of a database, tables, and word/images/file links. Aside from the ease of collaboration wit...",
      "reviewSource": "Organic",
      "incentivized": false,
      "productName": "Notion",
      "reviewText": "Notion is a collaborative cloud-based tool combining the benefits of a database, tables, and word/images/file links. Aside from the ease of collaboration wit...",
      "disliked": "Notion can be a bit clunky at first to learn. I suggest taking a quick tutorial before diving in. Although I learned it pretty quickly, there are features I ..."
    }
  ]
}
```

## Related APIs

To find products first use [`g2/products`](https://docs.mindcase.co/apis/g2/products); for Capterra use [`capterra/reviews`](https://docs.mindcase.co/apis/capterra/reviews); for Gartner use [`gartner/reviews`](https://docs.mindcase.co/apis/gartner/reviews).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.