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

# Trustpilot search

> Read a Trustpilot search page as JSON with the trustpilot-search parser. $1 per 1,000 calls. Send the page to scrape. Examples in cURL, TypeScript and Python.

Reads a Trustpilot search page, like trustpilot.com/search?query=stripe, and returns a list of products as JSON.

## Make a request

Send the page's URL to [scrape](https://docs.stophy.dev/api-reference/endpoint/scrape.md) with a `json` format that names the parser. Get an API key in the [Quickstart](https://docs.stophy.dev/quickstart).

```bash cURL theme={null}
curl -X POST https://api.stophy.dev/v1/scrape \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.trustpilot.com/search?query=payments","formats":[{"type":"json","parser":"trustpilot-search"}]}'
```

```typescript TypeScript theme={null}
const response = await fetch("https://api.stophy.dev/v1/scrape", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.STOPHY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://www.trustpilot.com/search?query=payments",
    formats: [{ type: "json", parser: "trustpilot-search" }],
  }),
});
console.log(await response.json());
```

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

import requests

response = requests.post(
    "https://api.stophy.dev/v1/scrape",
    headers={"Authorization": f"Bearer {os.environ['STOPHY_API_KEY']}"},
    json={
        "url": "https://www.trustpilot.com/search?query=payments",
        "formats": [{"type": "json", "parser": "trustpilot-search"}],
    },
)
print(response.json())
```

## Read the response

The parser's data is in `data.json`. Its fields include `results`, `cursor`, `page` and `total`. This sample is cut to the first items.

```json theme={null}
{
  "success": true,
  "data": {
    "json": {
      "results": [
        {
          "id": "50489e6800006400051ae0d6",
          "url": "https://www.trustpilot.com/review/stripe.com",
          "title": "https://stripe.com/payments/checkout",
          "brand": null,
          "description": null,
          "price": null,
          "originalPrice": null,
          "rating": 1.6,
          "reviewCount": 17569,
          "availability": null,
          "images": [],
          "categories": [
            "Payment Service"
          ],
          "seller": null,
          "companyDomain": "stripe.com",
          "website": "https://stripe.com",
          "stars": 1.5,
          "addressStreet": "510 Townsend Street",
          "addressCity": "San Francisco",
          "addressPostalCode": "94103",
          "addressCountry": "United States"
        }
      ],
      "cursor": null,
      "page": 1,
      "total": 273
    }
  }
}
```

## Options

Send options in the `options` object of the `json` format.

| Option | What it does |
| - | - |
| `page` | Page number, starting at 1. Trustpilot shows 10 pages of 10 companies without an account, so one search reaches at most 100 companies even when total is larger. Make the query more specific to reach the rest. |

## Price

\$1 per 1,000 calls. See [Pricing](https://docs.stophy.dev/account/pricing.md).

## Limits and errors

* The URL must be a Trustpilot search page, like trustpilot.com/search?query=stripe. Any other URL fails with `invalidRequest`.
* The answer comes back in `data.json`. If the page cannot be read, the call fails with an error code from [Errors](https://docs.stophy.dev/api-reference/errors.md).

## Related

* [Pre-built parsers](https://docs.stophy.dev/scrape/prebuilt-parsers) lists every parser.
* [Scrape](https://docs.stophy.dev/scrape/overview) has the options every scrape takes.
* [Trustpilot company](https://docs.stophy.dev/scrape/prebuilt-parsers/shopping/trustpilot-company.md)
* [Trustpilot reviews](https://docs.stophy.dev/scrape/prebuilt-parsers/shopping/trustpilot-reviews.md)
* [Amazon search](https://docs.stophy.dev/scrape/prebuilt-parsers/shopping/amazon-search.md)


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