Trustpilot Post API
Collect Trustpilot business details, ratings and reviews.
API Description
Trustpilot Post API — Collect Trustpilot business details, ratings and reviews.
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 |
|---|---|---|---|
| includeTopics | No | boolean | Include business review topics. Default: true; requires one extra collection request. |
Only the request parameters listed on this page are used; other fields are ignored. Pass pagination cursors back unchanged, without encoding, decoding or conversion.
Included comments are limited to one page. Use the corresponding comments operation for more.
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. |
| post | object | Post, video or business details. |
| comments | object[] | Root comments in comment mode. |
| pagination | object | Continuation cursor and whether more results are available. |
data.post Fields
| Field | Type | Description |
|---|---|---|
| id | string | null | Record identifier. |
| title | string | null | Title |
| identifyingName | string | null | Identifying name |
| url | string | null | Content URL. |
| websiteUrl | string | null | Website url |
| websiteTitle | string | null | Website title |
| profileImageUrl | string | null | Profile image url |
| customHeaderUrl | string | null | Custom header url |
| trustScore | number | null | Trust score |
| stars | number | null | Filter reviews by rating from 1 to 5. |
| numberOfReviews | number | null | Number of reviews |
| numberOfReviewsLast12Months | number | null | Number of reviews last12months |
| commentsCount | number | null | Platform-reported comment total; not the number billed. |
| ratings | object | null | Ratings |
| reviewLanguages | object[] | Review languages |
| categories | object[] | Categories |
| breadcrumb | any | Breadcrumb |
| countryCode | string | null | Country code |
| contactInfo | any | Contact info |
| isClaimed | boolean | Is claimed |
| isClosed | boolean | Is closed |
| isTemporarilyClosed | boolean | Is temporarily closed |
| isMerged | boolean | Is merged |
| isCollectingReviews | boolean | Is collecting reviews |
| locationsCount | number | null | Locations count |
| verification | any | Verification |
| consumerAlerts | any[] | Consumer alerts |
| claimedAt | object | null | Claimed at |
| isUsingPaidFeatures | boolean | Is using paid features |
| replyBehavior | any | Reply behavior |
| topics | object[] | 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. |
data.post.ratings Fields
| Field | Type | Description |
|---|---|---|
| total | number | null | Total |
| one | number | null | One |
| two | number | null | Two |
| three | number | null | Three |
| four | number | null | Four |
| five | number | null | Five |
data.post.reviewLanguages[] Fields
| Field | Type | Description |
|---|---|---|
| isoCode | string | null | Iso code |
| reviewCount | number | null | Review count |
| displayName | string | null | Display name |
data.post.categories[] Fields
| Field | Type | Description |
|---|---|---|
| id | string | null | Record identifier. |
| name | string | null | Name |
| isPrimary | boolean | Is primary |
data.post.claimedAt Fields
| Field | Type | Description |
|---|---|---|
| text | string | null | Text value. |
| value | number | null | Parsed value. |
data.post.topics[] Fields
| Field | Type | Description |
|---|---|---|
| id | string | Record identifier. |
| name | string | null | Name |
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 post, video or business. Included comments, replies and author details 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.

