API reference
G2 Reviews API
Reviews of a software product, ten per page, with rating, text, date and the reviewer's role, company size and industry; filterable by stars, segment, industry, role, region and keywords.
Endpoint
/v1/g2/reviewslive · proven8 creditsParameters
Query parameters
Useful optional inputs
sort— Choose the documented source ordering before paging through results.Ordering keeps the normal endpoint price and does not guarantee exhaustive results.
region— Select the documented source market or request location.Read this endpoint’s region semantics; it does not generally prove creator residence.
dry_run— Read a free estimate before fetching sources or scheduling paid work.Zero credits; cache status and availability are snapshots rather than guarantees.
| Name | Required | Description | Example |
|---|---|---|---|
product | yes | Product slug or the full G2 product URL | postman |
page | no | Page of 10 reviews; the response carries last_page and a cursor | 1 |
stars | no | Star ratings to include, comma-separated | 4,5 |
segment | no | small-business, mid-market or enterprise Accepted values: small-business, mid-market, enterprise. Case, spaces, hyphens and underscores are interchangeable. | mid-market |
industry | no | Industry ids from available_filters, comma-separated | 274 |
role | no | Reviewer role names or ids, comma-separated | user |
region | no | Reviewer region, comma-separated | Europe |
sort | no | default, most-recent, most-helpful, highest-rated or lowest-rated Accepted values: default, most-recent, most-helpful, highest-rated, lowest-rated. Case, spaces, hyphens and underscores are interchangeable. | most-recent |
keywords | no | Only reviews mentioning this text | api testing |
dry_run | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. | 1 |
Examples
Make the request
curl "https://www.monocrawl.com/v1/g2/reviews?product=postman" \ -H "x-api-key: mn_your_key_here"
TypeScript
const key = process.env.MONOCRAWL_API_KEY;
if (!key) throw new Error('Set MONOCRAWL_API_KEY on your server.');
const res = await fetch(
"https://www.monocrawl.com/v1/g2/reviews?product=postman",
{ headers: { "x-api-key": key } },
);
const body = await res.json();
if (!body.success) {
// one error shape for every endpoint — see /docs/errors
throw new Error(`${body.error.type}: ${body.error.message}`);
}
console.log(body.data, "credits left:", body.credits_remaining);Python
import os
import requests
res = requests.get(
"https://www.monocrawl.com/v1/g2/reviews?product=postman",
headers={"x-api-key": os.environ["MONOCRAWL_API_KEY"]},
timeout=60,
)
body = res.json()
if not body["success"]:
# one error shape for every endpoint — see /docs/errors
raise RuntimeError(f"{body['error']['type']}: {body['error']['message']}")
print(body["data"], "credits left:", body["credits_remaining"])Response
Response fields and example
This example is illustrative, not a captured live response. Variable-cost operations may settle a charge different from the list price below. A successful response puts the platform payload in data and reports the exact credits used, remaining balance, request id and cache status beside it.
{
"success": true,
"platform": "g2",
"endpoint": "/v1/g2/reviews",
"data": {
"count": 0,
"has_more": false,
"items": [
{
"dislikes": "example",
"helpful_count": 0,
"id": "example",
"likes": "example",
"nps_score": 0,
"platform": "example",
"posted_at": "2026-09-01T12:00:00Z",
"product": "example",
"reviewer": {
"name": "example"
},
"text": "example",
"title": "example"
}
],
"product": "example",
"total_reviews": 0
},
"credits_used": 8,
"credits_remaining": 99,
"request_id": "req_…",
"cached": false
}The example is illustrative and shows a documented subset of data. The fields below are optional across supported sources; nullable fields can also be absent. Preserve unknown values and accept additional fields.
Schema basis: observed response shapes, not an exhaustive field specification. See schema coverage and validation limits.
Download the data JSON Schema. Validate response.data, not the whole envelope. A valid shape does not establish that every field or source record was returned.
| Field inside data | Type | Meaning |
|---|---|---|
count | number | null | Number of records in this response, not lifetime or total matches. |
has_more | boolean | null | Source continuation indicator; null means unknown. |
items | array | null | Returned records. Source coverage and completeness vary. |
items[].dislikes | string | null | Optional dislikes supplied by this operation. Null means unknown. |
items[].helpful_count | number | null | Optional helpful count supplied by this operation. Null means unknown. |
items[].id | string | null | Source identifier. Preserve the supplied type and exact value. |
items[].likes | string | null | Optional likes supplied by this operation. Null means unknown. |
items[].nps_score | number | null | Optional nps score supplied by this operation. Null means unknown. |
items[].platform | string | null | Optional platform supplied by this operation. Null means unknown. |
items[].posted_at | string | null | Optional posted at supplied by this operation. Null means unknown. |
items[].product | string | null | Optional product supplied by this operation. Null means unknown. |
items[].reviewer | object | null | Optional reviewer supplied by this operation. Null means unknown. |
items[].reviewer.name | string | null | Optional name supplied by this operation. Null means unknown. |
items[].text | string | null | Source text when supplied. |
items[].title | string | null | Source title when supplied. |
product | string | null | Optional product supplied by this operation. Null means unknown. |
total_reviews | number | null | Optional total reviews supplied by this operation. Null means unknown. |
Optional fields reviewed from preserved successful responses. Additive fields and source variations remain allowed; validate the fields your workflow requires.
The example is invented and illustrates types only; zero and empty values are not claims about a real result.
Failures use the typed error envelope. A confirmed uncharged or refunded failure reports zero; a pending reconciliation can report an unknown charge. Read credits_used and error.details.billing_status, and keep request_id for recovery. Response contract · Error reference