↑ ↓ to move ↵ to open
Trustpilot API reference

Trustpilot Product Review Summary

trustpilot.product.summary.get

Read source-qualified per-star SKU or SKU-group counts and aggregate attributes from an entitled public product widget, keeping imported reviews separate.

At a glance

Endpoint ID
trustpilot.product.summary.get
Price
1 credit per call; failed calls are free
Runs for up to
30 seconds
Request
POST /execute
Run an endpoint
MCP tool when pinned
trustpilot__product__summary__get
Pin tools
OpenAPI
openapi.json
Download

Request

Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "trustpilot.product.summary.get",  "input": {    "business_unit_id": "615bed25d9362e001de1d4d9",    "expected_identifying_name": "mabelandfox.com",    "sku": "ARM - Under The Sea _010"  }}'

Input

FieldTypeRequiredWhat it doesExample
business_unit_id string yes Business unit identifier. 615bed25d9362e001de1d4d9
sku string yes One SKU or up to twenty distinct comma-separated SKUs from the merchant product widget; zero reviews does not verify product existence. ARM - Under The Sea _010
expected_identifying_name string no Optional exact source business-domain/path guard. mabelandfox.com
locale string no Locale to use for the request. Default: en-US.

Response

A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.

This is results[0].data from a real run:

results[0].data
{  "display_name": "Mabel & Fox",  "identifying_name": "mabelandfox.com",  "product_identity_verified": false,  "profile_url": "https://www.trustpilot.com/review/mabelandfox.com",  "template_id": "57177697fdb1180308e3815f",  "imported": {    "review_count": 39,    "stars_average": 4.9,    "distribution": {      "five_stars": 37,      "four_stars": 1,      "one_star": 0,      "three_stars": 1,      "two_stars": 0    }  },  "trustpilot": {    "review_count": 4,    "stars_average": 4,    "distribution": {      "five_stars": 3,      "four_stars": 0,      "one_star": 1,      "three_stars": 0,      "two_stars": 0    }  },  "attributes": [    {      "name": "Quality",      "rating": 5,      "id": "attributes.default.quality",      "rating_count": null,      "scale_max": 5,      "scale_min": 1    },    {      "name": "Value for money",      "rating": 4.2,      "id": "attributes.default.value-for-money",      "rating_count": null,      "scale_max": 5,      "scale_min": 1    }  ]}

Fields

FieldTypeExample
display_name string Mabel & Fox
attributes array 2 records
attributes[].id string attributes.default.quality
attributes[].name string Quality
attributes[].rating integer 5
attributes[].rating_count null null
attributes[].scale_max integer 5
attributes[].scale_min integer 1
identifying_name string mabelandfox.com
imported object 3 fields
imported.distribution object 5 fields
imported.distribution.five_stars integer 37
imported.distribution.four_stars integer 1
imported.distribution.one_star integer 0
imported.distribution.three_stars integer 1
imported.distribution.two_stars integer 0
imported.review_count integer 39
imported.stars_average number 4.9
product_identity_verified boolean false
profile_url string https://www.trustpilot.com/review/mabelandfox.com
template_id string 57177697fdb1180308e3815f
trustpilot object 3 fields
trustpilot.distribution object 5 fields
trustpilot.distribution.five_stars integer 3
trustpilot.distribution.four_stars integer 0
trustpilot.distribution.one_star integer 1
trustpilot.distribution.three_stars integer 0
trustpilot.distribution.two_stars integer 0
trustpilot.review_count integer 4
trustpilot.stars_average integer 4

If a call fails

A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.

Other Trustpilot endpoints

Something missing or unclear? Ask the team that builds the Trustpilot endpoints.