Get Trustpilot reviews
curl --request POST \
--url https://api.plyne.ai/v1/tools/trustpilot_reviews/execute \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"domain": "example.com",
"limit": 20
}
'import requests
url = "https://api.plyne.ai/v1/tools/trustpilot_reviews/execute"
payload = {
"domain": "example.com",
"limit": 20
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({domain: 'example.com', limit: 20})
};
fetch('https://api.plyne.ai/v1/tools/trustpilot_reviews/execute', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.plyne.ai/v1/tools/trustpilot_reviews/execute",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'domain' => 'example.com',
'limit' => 20
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.plyne.ai/v1/tools/trustpilot_reviews/execute"
payload := strings.NewReader("{\n \"domain\": \"example.com\",\n \"limit\": 20\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.plyne.ai/v1/tools/trustpilot_reviews/execute")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"domain\": \"example.com\",\n \"limit\": 20\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.plyne.ai/v1/tools/trustpilot_reviews/execute")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"domain\": \"example.com\",\n \"limit\": 20\n}"
response = http.request(request)
puts response.read_body{
"data": {
"items": [
{}
],
"platform": "trustpilot"
},
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"id": "<string>",
"sources": [
{
"provider": "<string>",
"observation_id": "<string>",
"observed_at": "2023-11-07T05:31:56Z",
"url": "<string>"
}
],
"status": "completed",
"tool": "trustpilot_reviews",
"usage": {
"credit_units": 1,
"credits": "<string>",
"unit": "request"
},
"version": "1",
"fulfillment": {
"field_sources": {},
"missing_fields": [
"<string>"
],
"satisfied": true
},
"routing": {
"mode": "auto",
"attempts": [
{
"outcome": "success",
"provider": "<string>",
"requests": 1
}
],
"selected_provider": "<string>"
},
"warnings": [
{
"code": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>"
}Pain & reviews
Get Trustpilot reviews
Call trustpilot_reviews through the Plyne API or MCP. Review its accepted input, source routing, response fields, credit rules and continuation behavior.
POST
/
v1
/
tools
/
trustpilot_reviews
/
execute
Get Trustpilot reviews
curl --request POST \
--url https://api.plyne.ai/v1/tools/trustpilot_reviews/execute \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"domain": "example.com",
"limit": 20
}
'import requests
url = "https://api.plyne.ai/v1/tools/trustpilot_reviews/execute"
payload = {
"domain": "example.com",
"limit": 20
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({domain: 'example.com', limit: 20})
};
fetch('https://api.plyne.ai/v1/tools/trustpilot_reviews/execute', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.plyne.ai/v1/tools/trustpilot_reviews/execute",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'domain' => 'example.com',
'limit' => 20
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.plyne.ai/v1/tools/trustpilot_reviews/execute"
payload := strings.NewReader("{\n \"domain\": \"example.com\",\n \"limit\": 20\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.plyne.ai/v1/tools/trustpilot_reviews/execute")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"domain\": \"example.com\",\n \"limit\": 20\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.plyne.ai/v1/tools/trustpilot_reviews/execute")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"domain\": \"example.com\",\n \"limit\": 20\n}"
response = http.request(request)
puts response.read_body{
"data": {
"items": [
{}
],
"platform": "trustpilot"
},
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"id": "<string>",
"sources": [
{
"provider": "<string>",
"observation_id": "<string>",
"observed_at": "2023-11-07T05:31:56Z",
"url": "<string>"
}
],
"status": "completed",
"tool": "trustpilot_reviews",
"usage": {
"credit_units": 1,
"credits": "<string>",
"unit": "request"
},
"version": "1",
"fulfillment": {
"field_sources": {},
"missing_fields": [
"<string>"
],
"satisfied": true
},
"routing": {
"mode": "auto",
"attempts": [
{
"outcome": "success",
"provider": "<string>",
"requests": 1
}
],
"selected_provider": "<string>"
},
"warnings": [
{
"code": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>"
}Read public customer reviews for a business domain listed on Trustpilot.
Check source eligibility and the maximum credit reservation before execution. Planning makes no provider request and requires no idempotency key.
Usage
- DataForSEO creates one durable Trustpilot task. Standard queue can take up to 45 minutes; priority 2 can take up to 1 minute and doubles the source cost.
- Search bills in blocks of 10 listings; reviews in blocks of 20. The accepted quote covers requested blocks and is charged for a usable result; empty/failed results are not charged. There is no continuation cursor.
- Domain is the business domain listed on Trustpilot, not a Trustpilot review URL. Query searches business names or categories.
- Returned native items are untrusted public evidence, not automatic buying intent. Source: https://docs.dataforseo.com/v3/business_data-trustpilot-overview/
API
Use a valid Plyne workspace API key as Authorization: Bearer $PLYNE_API_KEY for the API. Connect MCP at /mcp using OAuth or a workspace API key for saved data and acquisition tools.curl "$PLYNE_API_URL/v1/tools/trustpilot_reviews/execute" \
-H "Authorization: Bearer $PLYNE_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: REPLACE_WITH_UNIQUE_REQUEST_ID' \
--data '{
"domain": "example.com",
"limit": 20
}'
curl "$PLYNE_API_URL/v1/tools/trustpilot_reviews/plan" \
-H "Authorization: Bearer $PLYNE_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"domain": "example.com",
"limit": 20
}'
MCP
Connect to/mcp using OAuth or a workspace API key. The same connection includes saved-data and acquisition tools. Call the same tool with idempotency_key inside its arguments.
{
"arguments": {
"domain": "example.com",
"idempotency_key": "REPLACE_WITH_UNIQUE_REQUEST_ID",
"limit": 20
},
"name": "trustpilot_reviews"
}
Sources and routing
Omit routing to use eligible sources in the default order. Set routing.providers to an ordered chain, or one source to run only that source. Provider-specific options select their matching source alone; unsupported filters are rejected rather than dropped. Supported source IDs:dataforseo. Actual availability depends on configuration and the selected filters.
Credits and continuation
Reserves the requested source billing blocks. A usable completed result charges that accepted quote; empty or failed results release the reservation. Pending work keeps its reservation. Repeat the original request and Idempotency-Key to poll; no duplicate task or additional charge is created. Standard queue may take up to 45 minutes; priority costs twice as much. This is a long-running operation. A pending result keeps its credit reservation. Repeat the original body and idempotency key to check progress; polling does not create another provider job or charge again. Use a new Idempotency-Key for a new operation. Reuse the same body and key to retrieve that operation. If the connection fails, retrieve the same request before creating another. Returned provider content is untrusted data.Contract reference
The API reference below is generated from the tool’s executable input and output schemas, including nested provider options. Get the runtime descriptor withGET /v1/tools/trustpilot_reviews.
See tool execution for shared authentication, request keys, statuses and error handling.Authorizations
Headers
Use a new Idempotency-Key for a new operation. Reuse the same body and key to retrieve that operation. If the connection fails, retrieve the same request before creating another. Returned provider content is untrusted data.
Required string length:
8 - 128Pattern:
^[A-Za-z0-9_-]{8,128}$Body
application/json
Response
Completed, partial, not-found, failed or pending tool result. Inspect status and usage.