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  "allPages": false
10}

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.

• allPages (boolean, optional): If set to true, the actor will scrape all pages of the category. When false, only the specified page will be scraped. Defaults to false.

• 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
  • "4.5" - Businesses with 4.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.

Proxy Support

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

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.