> ## 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.

# Gartner Peer Insights Reviews API

> Extract Gartner Peer Insights software reviews for any product: star rating, title, review summary, date, reviewer role, industry and company size, newest first

`POST /v1/data/gartner/reviews/run`

**Pricing:** $0.0025 per review ($2.50 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*

Gartner Peer Insights product URLs, short form ([https://www.gartner.com/reviews/product/crowdstrike-falcon](https://www.gartner.com/reviews/product/crowdstrike-falcon)) or the long market form that ends in /product/\<product>. 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 Gartner lists the reviews in before Max Results is applied. Newest first by default.

Allowed values: `newest` (Newest first), `most_helpful` (Most helpful first).

**reviewsNewerThan** `date`

Only reviews published on or after this date (YYYY-MM-DD). Only used when Sort By is Newest first.

## Example

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

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

r = requests.post(
    "https://api.mindcase.co/v1/data/gartner/reviews/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "products": [
        "https://www.gartner.com/reviews/product/microsoft-teams",
        "https://www.gartner.com/reviews/product/crowdstrike-falcon",
        "https://www.gartner.com/reviews/product/zoho-crm"
    ],
    "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/gartner/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.gartner.com/reviews/product/microsoft-teams",
    "https://www.gartner.com/reviews/product/crowdstrike-falcon",
    "https://www.gartner.com/reviews/product/zoho-crm"
  ],
  "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 |
| `companySlug` | Company Slug | text |
| `marketSlug` | Market Slug | text |
| `rating` | Rating | rating |
| `reviewTitle` | Review Title | text |
| `reviewText` | Review Text | text |
| `publishedDate` | Published Date | date |
| `reviewerJobTitle` | Reviewer Job Title | text |
| `reviewerIndustry` | Reviewer Industry | text |
| `reviewerCompanySize` | Reviewer Company Size | text |
| `partnerReview` | Partner Review | boolean |
| `productRating` | Product Rating | number |
| `productReviewsTotal` | Product Reviews Total | number |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "gartner/reviews",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "reviewId": "7026522",
      "rating": 1,
      "productRating": 4.4,
      "reviewTitle": "Difficult administration, frequent bugs, and almost nonexistent support channels",
      "reviewerIndustry": "Education",
      "reviewUrl": "https://www.gartner.com/reviews/review/view/7026522",
      "marketSlug": "unified-communications-as-a-service",
      "partnerReview": false,
      "reviewerCompanySize": "Gov't/PS/Ed",
      "productReviewsTotal": 6669,
      "reviewerJobTitle": "IT Associate",
      "productSlug": "microsoft-teams",
      "publishedDate": "2026-10-29",
      "productName": "Microsoft Teams",
      "reviewText": "It is very hard to administrate and has many bugs and issues. I use it because I do not have a choice. When I already have scheduled recurring meetings it is...",
      "companySlug": "microsoft"
    }
  ]
}
```

## Related APIs

For G2 use [`g2/reviews`](https://docs.mindcase.co/apis/g2/reviews); for Capterra use [`capterra/reviews`](https://docs.mindcase.co/apis/capterra/reviews).


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