Trustpilot Category Scraper

This Apify actor scrapes business data from specific Trustpilot categories. 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:

1{
2  "category": "gaming",
3  "page": "1",
4  "country": "US",
5  "location": "New York, NY",
6  "claimed": false,
7  "verified": false,
8  "trustscore": "3.0"
9}

Parameters Breakdown

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

• page (string, optional): The page number to scrape for the specified category. Defaults to 1.

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

• location (string, optional): A city or zip code to filter results based on a specific location. Example: "New York, NY".

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

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

• trustscore (string, optional): Filter businesses based on Trustpilot ratings. Options include:

  • "" - All ratings
  • "3.0" - Businesses with 3 stars or more
  • "4.0" - Businesses with 4 stars or more
  • "5.0" - Businesses with 5 stars only

Output Structure

The output is an array of objects representing local businesses. Here’s the TypeScript interface definition for 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 specified category.

• pages: Total number of pages for the specified category.

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.

Example

Input Example

1{
2  "category": "gaming",
3  "page": 2,
4  "country": "US",
5  "location": "San Francisco, CA",
6  "claimed": true,
7  "verified": false,
8  "trustscore": "4.0"
9}

Output Example

1{
2  "businesses": [
3    {
4      "ID": "12345",
5      "domain": "example.com",
6      "ratingValue": "4.5",
7      "reviewCount": "1500",
8      "name": "Example Gaming Company",
9      "description": "The best gaming company.",
10      "image": "https://example.com/logo.png",
11      "country": "US",
12      "address": "123 Main St",
13      "city": "San Francisco",
14      "zipCode": "94103",
15      "website": "https://example.com",
16      "email": "info@example.com",
17      "phone": "+1-800-123-4567",
18      "categories": ["Gaming", "Entertainment"],
19      "categoriesID": ["gaming", "entertainment"]
20    }
21  ],
22  "total": 100,
23  "pages": 5
24}

Disclaimer

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