Trustpilot Scraper

This Apify actor scrapes business data from Trustpilot using either category filtering or keyword search. You can filter the results based on location, verification status, trustscore, and more.

Table of Contents

• Input Parameters
• Output Structure
• Usage
• Example

Input Parameters

The input parameters are defined as a JSON object with the following fields:

{
  "category": "gaming",
  "page": "1",
  "country": "US",
  "location": "New York, NY",
  "claimed": false,
  "verified": false,
  "trustscore": "3.0",
  "allPages": false,
  "sortBy": "recommended",
  "withLastReviews": false
}

Or for search mode:

{
  "search": "gaming",
  "page": "1",
  "claimed": false,
  "verified": false,
  "trustscore": "3.0",
  "allPages": false,
  "numberOfReviews": "any",
  "withLastReviews": false
}

Parameters Breakdown

• searchType (string, detected automatically): The mode will be automatically detected based on whether you provide a category or search field.

• withLastReviews (boolean): If set to true, the actor will fetch the last reviews for each company. Note that this will increase the scraping time. Defaults to false.

Category Options

These settings apply when using searchType: "category":

• category (string): The Trustpilot category you want to scrape. Examples: bank, gaming, tech. These correspond to URLs like https://www.trustpilot.com/categories/bank.

• country (string): Country code for filtering results by a specific country. Example values: US, IT, GB.

• location (string): City or Zip Code to filter results. Example: "New York, NY".

Category Sorting Options

These sorting options only apply when using Category Filter:

• sortBy (string): Sort results by relevance, number of reviews, or recency. Options:
  • recommended: Most Relevant (default)
  • reviews_count: Highest number of reviews
  • latest_review: Most recent reviews

Search Query Settings

These settings apply when using Keyword Search:

• search (string): Specify the search query you want to scrape. Example: bank for https://www.trustpilot.com/search?q=bank.

Search Filtering Options

These filtering options only apply when using Keyword Search:

• numberOfReviews (string): Only companies with a number of reviews greater than or equal to the specified value. Options:
  • any: Any number of reviews (default)
  • 25: 25+ reviews
  • 50: 50+ reviews
  • 100: 100+ reviews
  • 250: 250+ reviews
  • 500: 500+ reviews

Filtering Options

Filter results by various criteria:

• trustscore (string): Only companies with a trustscore greater than or equal to the specified value. Options:

  • "": All ratings
  • "3.0": >= 3 Stars
  • "4.0": >= 4 Stars
  • "4.5": >= 4.5 Stars

• claimed (boolean): If set to true, only scrapes businesses that have claimed their profiles.

• verified (boolean): If set to true, only scrapes businesses that have verified their profiles.

Pagination Settings

• page (string): The page number you want to scrape or start from. Defaults to 1.

• allPages (boolean): If true, the actor will scrape all pages of the category. Please note that timeouts may occur if the category has a lot of pages. Defaults to false.

Output Structure

The output is an array of objects representing businesses. Here's the structure of the scraped data:

• businesses: An array of businesses that match the specified input criteria.

  • ID: Unique ID of the business.
  • domain: Domain name of the business.
  • ratingValue: Trustpilot rating of the business.
  • reviewCount: Number of reviews the business has received.
  • name: Name of the business.
  • description : Short description of the business.
  • image : Image URL of the business logo or profile.
  • country : Country where the business is based.
  • address : Physical address of the business.
  • city : City where the business is located.
  • zipCode : Zip code of the business location.
  • website : Business website URL.
  • email : Email contact of the business.
  • phone : Business phone number.
  • categories : Categories the business belongs to.
  • categoriesID : Category IDs the business is associated with.

• total: The total number of businesses found for the query.

• pages: Total number of pages for the results.

Usage

1. Define your inputs: Create a JSON file with your desired input parameters (see Input Parameters section).
2. Run the actor: Trigger the Apify actor with your JSON input.
3. Download the output: The scraped data will be saved in the output storage. You can access it via Apify's storage API or directly through the Apify interface.

Proxy Support

The actor automatically uses Apify's proxy infrastructure to ensure reliable and efficient scraping.

Example

Category Filter Example

{
  "category": "gaming",
  "page": "2",
  "country": "US",
  "location": "San Francisco, CA",
  "claimed": true,
  "verified": false,
  "trustscore": "4.0",
  "sortBy": "reviews_count"
}

Keyword Search Example

{
  "search": "online gaming",
  "page": "1"
}

Output Example

{
  "businesses": [
    {
      "ID": "12345",
      "domain": "example.com",
      "ratingValue": "4.5",
      "reviewCount": "1500",
      "name": "Example Gaming Company",
      "description": "The best gaming company.",
      "image": "https://example.com/logo.png",
      "country": "US",
      "address": "123 Main St",
      "city": "San Francisco",
      "zipCode": "94103",
      "website": "https://example.com",
      "email": "info@example.com",
      "phone": "+1-800-123-4567",
      "categories": ["Gaming", "Entertainment"],
      "categoriesID": ["gaming", "entertainment"]
      "lastReviews": [
          {
              "id": "abc123xyz",
              "text": "Great experience with this company!",
              "title": "Excellent Service and Products",
              "rating": 5,
              "date": {
                "createdAt": "2024-01-15T10:30:00.000Z"
              },
              "consumer": {
                "id": "user123",
                "displayName": "JohnDoe",
                "imageUrl": "https://example.com/avatar.jpg",
                "isVerified": true,
                "numberOfReviews": 10,
                "countryCode": "US"
              }
          }
      ]
    }
  ],
  "total": 100,
  "pages": 5
}

Disclaimer

This actor is intended to help you get structured data from Trustpilot. It is not intended to be used against Trustpilot's Terms of Service.