> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hasdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trustpilot Reviews API

The Trustpilot Reviews API returns a company's Trustpilot reviews - title, text, rating, dates, language, verified label, useful count, author and company reply - with filters by star rating, language, date, verified and replied status. The country sets the default review language, and an explicit language overrides it.

> [!NOTE]
>
> HasData is an independent service and is not affiliated with, endorsed by, or sponsored by Trustpilot. Trustpilot is a trademark of its respective owner. This API works with publicly available data only.

## Get Your API Key

Sign in at [hasdata.com](https://app.hasdata.com/sign-in), go to your account settings, and copy your API key.
All requests must include your key in the `x-api-key` header.

## Request Cost and API Credits

Each request to the Trustpilot Reviews API consumes **API Credits** from your account balance.

* **Cost per request:** 10 API Credits
* Credits are deducted only for successful requests.
* Your total available credits depend on your active plan.

> [!TIP]
>
> You can use your credits across all HasData APIs. The same credit balance is shared platform-wide.

> [!WARNING]
>
> **Unused credits do not roll over.** Any remaining credits expire at the end of the current billing period.

To monitor your credit usage and remaining balance, sign in to your account dashboard at [app.hasdata.com](https://app.hasdata.com/sign-in).

## Make Your First Request

```bash cURL theme={null}
curl --request GET -G \
  --url 'https://api.hasdata.com/scrape/trustpilot/reviews' \
  --data-urlencode 'company=www.amazon.com' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <your-api-key>'
```

```javascript Node.js theme={null}
const axios = require('axios').default;

const options = {
  method: 'GET',
  url: 'https://api.hasdata.com/scrape/trustpilot/reviews',
  params: {company: 'www.amazon.com'},
  headers: {'Content-Type': 'application/json', 'x-api-key': '<your-api-key>'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```python Python theme={null}
import requests

url = "https://api.hasdata.com/scrape/trustpilot/reviews"

querystring = {"company":"www.amazon.com"}

headers = {
    "Content-Type": "application/json",
    "x-api-key": "<your-api-key>"
}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())
```

```php PHP theme={null}
<?php

$params = [
    "company" => "www.amazon.com",
];

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hasdata.com/scrape/trustpilot/reviews?" . http_build_query($params),
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <your-api-key>",
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;
```

```java Java theme={null}
OkHttpClient client = new OkHttpClient();

HttpUrl url = HttpUrl.parse("https://api.hasdata.com/scrape/trustpilot/reviews")
  .newBuilder()
  .addQueryParameter("company", "www.amazon.com")
  .build();

Request request = new Request.Builder()
  .url(url)
  .get()
  .addHeader("Content-Type", "application/json")
  .addHeader("x-api-key", "<your-api-key>")
  .build();

Response response = client.newCall(request).execute();
```

```csharp C# theme={null}
using System.Net.Http;
using System.Web;

var client = new HttpClient();

var query = HttpUtility.ParseQueryString(string.Empty);
query["company"] = "www.amazon.com";

var url = $"https://api.hasdata.com/scrape/trustpilot/reviews?{query}";

var request = new HttpRequestMessage(new HttpMethod("GET"), url);
request.Headers.Add("x-api-key", "<your-api-key>");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
```

```ruby Ruby theme={null}
require 'net/http'
require 'uri'

uri = URI("https://api.hasdata.com/scrape/trustpilot/reviews")
params = {
  "company" => "www.amazon.com",
}
uri.query = URI.encode_www_form(params)

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["Content-Type"] = 'application/json'
request["x-api-key"] = '<your-api-key>'

response = http.request(request)
puts response.read_body
```

```rust Rust theme={null}
use reqwest::blocking::Client;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let res = client
        .get("https://api.hasdata.com/scrape/trustpilot/reviews")
        .query(&[("company", "www.amazon.com")])
        .header("Content-Type", "application/json")
        .header("x-api-key", "<your-api-key>")
        .send()?
        .text()?;
    println!("{}", res);
    Ok(())
}
```

```go Go theme={null}
package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	params := url.Values{}
	params.Set("company", "www.amazon.com")

	u := "https://api.hasdata.com/scrape/trustpilot/reviews?" + params.Encode()

	req, _ := http.NewRequest("GET", u, nil)
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("x-api-key", "<your-api-key>")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}
```

## API Parameters

| Parameter | Default Value | Required | Description |
| - | - | - | - |
| `company` | [www.amazon.com](http://www.amazon.com) | Yes | Company domain as in `trustpilot.com/review/{company}`, e.g. `www.amazon.com`. A full Trustpilot URL also works. |
| `sortBy` | - | No | Review order. |
| `search` | - | No | Only reviews whose text matches this keyword, e.g. `delivery`. |
| `stars[]` | - | No | Only reviews with these star ratings. Multiple values are combined with OR. |
| `date` | - | No | Only reviews within this period. |
| `verified` | - | No | Only verified reviews. |
| `withReplies` | - | No | Only reviews the company replied to. |
| `page` | - | No | Page number, 20 reviews per page. Logged-out access is capped at 10 pages (200 reviews) per filter combination. |
| `country` | - | No | Trustpilot country site to read the company from. Reviews are shared across sites; the country sets the default review language (e.g. `de` German, `br` Portuguese), which the `language` parameter can override. Default is `www` (English). |
| `language` | - | No | Review language as an ISO code, e.g. `en`, `de`, `ru`, `ar`, or `all` for every language. Overrides the language implied by the country, and reaches languages that have no country site. Defaults to the country's language. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.