# Trustpilot

### Overview

Birdie can import public customer reviews from [Trustpilot](https://www.trustpilot.com/), a global platform where customers share feedback on businesses, products, and services.

The Trustpilot connector collects publicly available reviews from company pages on trustpilot.com. No API credentials or authentication are required — Birdie reads the same public data that any visitor can see on the Trustpilot website.

### Requirements

To set up the integration, you need:

* The Trustpilot URL(s) for the company you want to monitor
* To indicate whether each URL belongs to your company (Owner) or a competitor

No API key, OAuth token, or any other credential is needed.

### Finding Your Company URL

1. Go to [trustpilot.com](https://www.trustpilot.com/).
2. Search for the company name in the search bar.
3. Copy the URL of the company page.

The URL follows the pattern: `https://www.trustpilot.com/review/<company-domain>`

A company may have multiple pages, especially if it is not a Trustpilot partner. You can provide multiple URLs to cover all pages.

Example for Slack:

* `https://www.trustpilot.com/review/slack.com`
* `https://www.trustpilot.com/review/app.slack.com`

### Share Configuration with Birdie

Provide the following to the Birdie team:

```json
{
  "data_source": {
    "urls": [
      "https://www.trustpilot.com/review/your-company.com",
      "https://www.trustpilot.com/review/your-other-page.com"
    ],
    "owner": "Owner"
  }
}
```

| Section       | Field   | Required | Description                                                               |
| ------------- | ------- | -------- | ------------------------------------------------------------------------- |
| `data_source` | `urls`  | Yes      | List of Trustpilot company page URLs to monitor.                          |
| `data_source` | `owner` | Yes      | `Owner` if this is your company, `Competitor` if monitoring a competitor. |

Since no credentials are involved, you can share this configuration via any channel. For consistency, you can also use the [secure sharing process](https://ask.birdie.ai/integrations-and-data-ingestion/securely-sharing-credentials-for-data-integration).

### Data Imported

Birdie imports the following from each review:

* Review text and title
* Rating (1-5 stars)
* Date posted
* Author name
* Language

Reviews are imported as **feedback (review)** records in Birdie.

### References

* [Trustpilot](https://www.trustpilot.com/)
* [Securely Sharing Credentials](https://ask.birdie.ai/integrations-and-data-ingestion/securely-sharing-credentials-for-data-integration)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ask.birdie.ai/integrations-and-data-ingestion/how-to-integrate-with/trustpilot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.