List reviews across all connected platforms with rich filters, pagination, and sort.
Parameters 12
| Name | In | Type | Description | |
|---|---|---|---|---|
| page | query | integer | 1-indexed page number. Defaults to the server-side pagination default. | page 1-indexed page number. Defaults to the server-side pagination default. |
| limit | query | integer | Items per page. Defaults to the server-side pagination default. | limit Items per page. Defaults to the server-side pagination default. |
| sort | query | ReviewSortEnum | Sort order for the result set. Defaults to highest_rating. | sort Sort order for the result set. Defaults to highest_rating. |
| minRating | query | integer | Minimum star rating (1–5). | minRating Minimum star rating (1–5). |
| rating | query | integer | Exact star rating (1–5). When present, overrides minRating / maxRating. | rating Exact star rating (1–5). When present, overrides minRating / maxRating. |
| platform | query | ReviewPlatform | Filter by source platform (app_store, google_play, g2, google_business, trustpilot, yelp). | platform Filter by source platform (app_store, google_play, g2, google_business, trustpilot, yelp). |
| maxRating | query | integer | Maximum star rating (1–5). | maxRating Maximum star rating (1–5). |
| authorName | query | string | Substring match on the reviewer's display name. | |
| productName | query | string | Substring match on the product or listing name. | productName Substring match on the product or listing name. |
| hasResponse | query | boolean | Return only reviews with (true) or without (false) an existing reply. | hasResponse Return only reviews with (true) or without (false) an existing reply. |
| fromDate | query | ISO-8601 | Lower bound on createdAt. ISO-8601 date or date-time. | fromDate Lower bound on createdAt. ISO-8601 date or date-time. |
| toDate | query | ISO-8601 | Upper bound on createdAt. ISO-8601 date or date-time. | toDate Upper bound on createdAt. ISO-8601 date or date-time. |
{
"data": [
{
"id": "rev_7b3d9c42-8f1a-4d21-9e6a-2b4f8c1e0a33",
"platformReviewId": "g2-rev-7b3d9c42",
"platform": "g2",
"rating": 5,
"title": "Saved our eng team a full sprint",
"text": "Centralized reviews across Play Store and G2 in under an hour. Webhooks just worked.",
"authorId": "g2_user_8821",
"authorName": "Maya Chen",
"productId": "g2_prod_2201",
"productName": "reviewhook.dev",
"createdAt": "2026-04-18T14:22:08Z",
"updatedAt": "2026-04-18T14:22:08Z",
"hasResponse": false
},
{
"id": "rev_3a1f8c0e-44b2-4e9a-b7c3-9d02e1f4ab77",
"platformReviewId": "1234567890-abc",
"platform": "app_store",
"rating": 4,
"title": "Great, one nit",
"text": "Filters are fast. Would love darkmode for the portal.",
"authorName": "dev_pascal",
"productName": "reviewhook iOS",
"appVersion": "2.3.1",
"deviceInfo": { "osVersion": "iOS 17.4" },
"createdAt": "2026-04-17T09:02:40Z",
"updatedAt": "2026-04-20T11:48:02Z",
"hasResponse": true,
"responseStatus": "sent",
"response": {
"text": "Dark mode ships in 2.4 — appreciate the nudge!",
"authorId": "u_team_09",
"authorName": "reviewhook team",
"createdAt": "2026-04-20T11:48:00Z"
}
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 184,
"totalPages": 10
}
} › Response schema 2 fields +4 nested
Array of matching reviews. Up to limit items.
Cursor metadata for the current page.
Unified review ID assigned by reviewhook.
Original review ID from the source platform.
Source platform enum. app_store · google_play · g2 · google_business · trustpilot · yelp.
Star rating on a 1–5 scale, normalized across platforms.
Review headline. Omitted where the platform has no title field.
Full review body, UTF-8.
Platform-specific author identifier. Omitted when anonymous.
Display name as shown on the platform. Omitted when anonymous.
Product identifier on the source platform.
Product or listing name at time of review.
App build the reviewer was on (mobile stores only).
Device metadata for mobile-store reviews.
When the review was posted on the source platform.
Last modification — edits, translations, or response changes.
True when the brand has replied to this review.
Upstream delivery state of the reply — queued · sent · failed.
Nested response object. Present only when hasResponse is true.
Reply body as posted to the platform.
Identifier of the team member who replied.
Display name attached to the reply.
When the reply was posted upstream.
Operating-system version string reported by the source, e.g. iOS 17.4 or Android 14.
1-indexed page number echoed back.
Items per page that were returned.
Total reviews matching the filter.
Ceiling of total / limit.