---
title: "Search Trustpilot business units"
method: GET
path: "/trustpilot/business-units/search"
tags: ["Trustpilot"]
---

# Search Trustpilot business units

`GET /trustpilot/business-units/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/trustpilot/business-units/search`
- Auth: API key in header `x-api-key`

Searches Trustpilot for businesses matching a query, for a country (default `US`), with `page` and `page_size` (default 20, max 100). Each result has the display name, identifying name, TrustScore, star rating, review count, categories, website, email, phone, address and Trustpilot URL; `total_hits` gives the full match count.

## Query parameters

- `q` string, required
- `country` string
- `page` integer
- `page_size` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TrustpilotBusinessSearchResponseDoc
  - `code` integer
  - `data` TrustpilotSearchResponse
    - `country` string: Two-letter country code the search was run for.
    - `items` TrustpilotSearchResult[]: Businesses matching the query on this page.
      - `address` TrustpilotSearchAddress
        - `approximate_area` TrustpilotSearchAreaBounds
          - `north_west` TrustpilotSearchCoordinates
            - `lat` number: Latitude in decimal degrees.
            - `lon` number: Longitude in decimal degrees.
          - `south_east` TrustpilotSearchCoordinates
            - `lat` number: Latitude in decimal degrees.
            - `lon` number: Longitude in decimal degrees.
        - `city` string: City of the business.
        - `coordinates` TrustpilotSearchCoordinates
          - `lat` number: Latitude in decimal degrees.
          - `lon` number: Longitude in decimal degrees.
        - `country` string: Country name of the business.
        - `country_code` string: Country code of the business, such as `US`.
        - `postcode` string: Postal code of the business.
        - `street` string: Street address of the business.
      - `business_unit_id` string: Trustpilot id of the business.
      - `categories` TrustpilotSearchCategory[]: Categories the business is listed under.
        - `id` string: Trustpilot category id, such as `software_company`.
        - `name` string: Display name of the category.
        - `primary` boolean: Whether this is the business's primary category.
      - `country_code` string: Country code of the business, such as `FR`.
      - `display_name` string: Display name of the business on Trustpilot.
      - `email` string: Contact email address of the business.
      - `identifying_name` string: Business slug used in the Trustpilot profile URL, usually the website domain. Use it with the business endpoint.
      - `logo_url` string: URL of the business's logo.
      - `phone` string: Contact phone number of the business.
      - `predicted_top_category` TrustpilotSearchCategory
        - `id` string: Trustpilot category id, such as `software_company`.
        - `name` string: Display name of the category.
        - `primary` boolean: Whether this is the business's primary category.
      - `review_count` integer: Total number of reviews the business has on Trustpilot.
      - `stars` number: Star rating of the business, out of 5.
      - `trust_score` number: Trustpilot TrustScore of the business, as a decimal number.
      - `trustpilot_url` string: URL of the business profile on Trustpilot.
      - `verified` boolean: Whether Trustpilot marks the business as verified.
      - `website_url` string: Website address of the business.
    - `page` integer: Page number returned.
    - `page_size` integer: Number of results per page.
    - `query` string: Query that was run.
    - `search_mode` string: How Trustpilot matched the query, such as `keyword`.
    - `total_hits` integer: Total number of businesses matching the query.
    - `total_pages` integer: Total number of result pages.
  - `msg` string

## Other responses

- `400`: Missing or invalid query parameters
- `404`: No results found
- `429`: Rate limit exceeded
- `500`: Internal server error
- `503`: Trustpilot upstream request failed

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)