Trustpilot Comments API
Collect Trustpilot comments using the pagination, ordering and filters listed for this operation.
API Description
Trustpilot Comments API — Collect Trustpilot comments using the pagination, ordering and filters listed for this operation.
Authenticate with your Pangolinfo API Key to receive structured JSON data.
Request URL
Request Headers
| Parameters | Parameter value | Type | Description |
|---|---|---|---|
| Content-Type | application/json | string | Data format |
| Authorization | Bearer xxx | string | Authorization Token |
Collection takes up to approximately 75 seconds. Set your client timeout to 90 seconds.
Request Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| target | Yes | string | Target URL, supported ID or search keyword for this operation. |
| options | No | object | Optional collection settings, described below. |
options Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| maxPages | No | integer | Pages to collect. Default: 1; values above 5 are capped at 5. Must be a positive integer. Default: 1 Minimum: 1 Maximum: 5 |
| cursor | No | string | null | Continuation cursor from the previous response. Pass the value unchanged. |
| sort | No | string | Result ordering. Supported values are listed below. |
| languages | No | string | Review language codes, e.g. en or de. Default: all. |
| stars | No | integer | Filter reviews by rating from 1 to 5. Minimum: 1 Maximum: 5 |
| date | No | string | Review publication date range; unrestricted by default. Values: [“last30days”, “last3months”, “last6months”, “last12months”] |
| topics | No | string[] | string | Up to 10 topic IDs from post.topics[].id, as a string array or comma-separated string. Whitespace and empty entries are removed. Multiple topics form an intersection. |
Only the request parameters listed on this page are used; other fields are ignored. Pass pagination cursors back unchanged, without encoding, decoding or conversion.
One page by default, capped at five per request. Page counts must be positive integers; higher values are capped at five.
topics accepts up to 10 IDs as an array or comma-separated string. Whitespace and empty entries are removed; multiple IDs form an intersection. Business topic metadata is not fetched separately.
Response Fields
| Field | Type | Description |
|---|---|---|
| code | integer | Status code; 0 indicates success. |
| message | string | Response message; ok on success. |
| pointCost | number | Points charged for this request. |
| data | object | Collected data, with fields described below. |
| meta | object | Request identifier and duration in milliseconds. |
| billing | object | Charged units, unit price and billing rule version. |
data Fields
| Field | Type | Description |
|---|---|---|
| type | string | Result type. |
| commentsCount | number | null | Platform-reported comment total; not the number billed. |
| comments | object[] | Root comments in comment mode. |
| pagination | object | Continuation cursor and whether more results are available. |
data.comments[] Fields
| Field | Type | Description |
|---|---|---|
| id | string | Record identifier. |
| url | string | Content URL. |
| title | string | null | Title |
| content | string | null | Content text; may be null for records without text. |
| rating | number | null | Rating |
| likes | number | null | Like count. |
| language | string | null | Selected subtitle language. |
| source | string | null | Source |
| time | object | null | Publication time. |
| experiencedAt | object | null | Experienced at |
| updatedAt | object | null | Updated at |
| nickname | string | null | Author display name. |
| avatar | string | null | Avatar URL. |
| profileUrl | string | null | Author profile URL. |
| poster | object | Poster |
| verification | object | Verification |
| location | any | Location |
| productReviews | any[] | Product reviews |
| consumersReviewCountOnSameDomain | number | null | Consumers review count on same domain |
| merchantReply | object | null | Merchant reply |
data.comments[].time Fields
| Field | Type | Description |
|---|---|---|
| text | string | null | Text value. |
| value | number | null | Parsed value. |
data.comments[].experiencedAt Fields
| Field | Type | Description |
|---|---|---|
| text | string | null | Text value. |
| value | number | null | Parsed value. |
data.comments[].updatedAt Fields
| Field | Type | Description |
|---|---|---|
| text | string | null | Text value. |
| value | number | null | Parsed value. |
data.comments[].poster Fields
| Field | Type | Description |
|---|---|---|
| id | string | null | Record identifier. |
| countryCode | string | null | Country code |
| reviewsCount | number | null | Reviews count |
| verified | boolean | Verified |
data.comments[].verification Fields
| Field | Type | Description |
|---|---|---|
| isVerified | boolean | Is verified |
| level | string | null | Level |
| source | string | null | Source |
data.comments[].merchantReply Fields
| Field | Type | Description |
|---|---|---|
| content | string | null | Content text; may be null for records without text. |
| time | object | null | Publication time. |
| updatedAt | object | null | Updated at |
data.pagination Fields
| Field | Type | Description |
|---|---|---|
| comments | object | Root comments in comment mode. |
data.pagination.comments Fields
| Field | Type | Description |
|---|---|---|
| cursor | string | null | Continuation cursor from the previous response. Pass the value unchanged. |
| hasMore | boolean | Whether more results are available. |
Request Example
Response Example
This excerpt shows the first item of each list. Long text and URLs are shortened; pointCost is the charge for the complete response. The playground contains the full schema.
Points Usage
0.8 points per root comment; included replies are free. Supported explicit reply modes charge 0.8 points per direct reply; nested replies included with those results are free.
Empty results and failed requests are not charged. Duplicate IDs are counted once within a response. Separate calls and pages are billed separately. See Social Media Reviews API billing.

