{
  "openapi": "3.0.1",
  "info": {
    "title": "Trustpilot Reviews Scraper - Ratings, Replies & 200+ Reviews",
    "description": "Scrape Trustpilot reviews of any company by domain, URL or name: rating, title, full text, dates, verification, reviewer, country and the company reply. Reads past the 200-review page limit, every language, star/date/topic filters, monitor mode. No login. $0.23 per 1,000 reviews.",
    "version": "0.1",
    "x-build-id": "heV8nfMqasHGHoNEe"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~trustpilot-reviews-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-trustpilot-reviews-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/topapi~trustpilot-reviews-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-trustpilot-reviews-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/topapi~trustpilot-reviews-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-trustpilot-reviews-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "companyUrls": {
            "title": "Companies",
            "type": "array",
            "description": "Domains, Trustpilot review URLs or company website URLs, one per line, e.g. \"www.amazon.com\", \"https://www.trustpilot.com/review/booking.com\", \"https://de.trustpilot.com/review/zalando.de\".",
            "items": {
              "type": "string"
            }
          },
          "searchTerms": {
            "title": "Company names",
            "type": "array",
            "description": "Company names to look up with Trustpilot's own search, e.g. \"Booking.com\", \"Revolut\". The top match is scraped (see Companies per name). Up to 100 names per run.",
            "items": {
              "type": "string"
            }
          },
          "maxCompaniesPerSearch": {
            "title": "Companies per name",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many search matches to scrape for each company name, best match first, up to 20 (Trustpilot's first two search pages). Default 1.",
            "default": 1
          },
          "stars": {
            "title": "Star ratings",
            "type": "array",
            "description": "Only reviews with these star ratings. Empty = all ratings.",
            "items": {
              "type": "string",
              "enum": [
                "5",
                "4",
                "3",
                "2",
                "1"
              ],
              "enumTitles": [
                "5 stars - Excellent",
                "4 stars - Great",
                "3 stars - Average",
                "2 stars - Poor",
                "1 star - Bad"
              ]
            }
          },
          "languages": {
            "title": "Review languages",
            "type": "array",
            "description": "Only reviews written in these languages, as ISO codes, e.g. \"en\", \"de\", \"fr\". Empty = every language (Trustpilot's own page shows only one).",
            "items": {
              "type": "string"
            }
          },
          "date": {
            "title": "Date range",
            "enum": [
              "",
              "last30days",
              "last3months",
              "last6months",
              "last12months"
            ],
            "type": "string",
            "description": "Only reviews published within this window. For an exact cutoff use Published after.",
            "default": ""
          },
          "topics": {
            "title": "Topics",
            "type": "array",
            "description": "Only reviews Trustpilot tags with these topics, e.g. \"customer_service\", \"delivery_service\", \"refund\". Empty = all topics.",
            "items": {
              "type": "string"
            }
          },
          "verified": {
            "title": "Verified reviews only",
            "type": "boolean",
            "description": "Only reviews Trustpilot labels as verified.",
            "default": false
          },
          "withReplies": {
            "title": "Only reviews with a company reply",
            "type": "boolean",
            "description": "Only reviews the company has answered.",
            "default": false
          },
          "search": {
            "title": "Keyword in review",
            "type": "string",
            "description": "Only reviews containing this word or phrase (Trustpilot's own review search), e.g. \"refund\"."
          },
          "sort": {
            "title": "Sort",
            "enum": [
              "recency",
              "relevance"
            ],
            "type": "string",
            "description": "Newest first (Trustpilot's default) suits monitoring and date cutoffs; Most relevant is Trustpilot's relevance ranking.",
            "default": "recency"
          },
          "publishedAfter": {
            "title": "Published after",
            "type": "string",
            "description": "Only reviews published strictly after this date-time, e.g. \"2026-09-01\" or \"2026-09-01T12:00:00Z\". Newest-first reading stops once it is passed."
          },
          "lookbackDays": {
            "title": "Last N days",
            "minimum": 0,
            "maximum": 3650,
            "type": "integer",
            "description": "Only reviews from the last N days. 0 = no limit. Pairs well with a daily schedule.",
            "default": 0
          },
          "countryOfReviewer": {
            "title": "Reviewer country",
            "type": "string",
            "description": "Only reviews by reviewers from this country, as a 2-letter code, e.g. \"US\", \"GB\", \"DE\"."
          },
          "includeCompanyInfo": {
            "title": "Company fields on every review",
            "type": "boolean",
            "description": "Adds the company's name, domain, TrustScore, stars, review count, categories, claimed flag and website to every review row. Free.",
            "default": true
          },
          "includeCompanyDetails": {
            "title": "Company details row",
            "type": "boolean",
            "description": "Adds one row per company: star and language breakdown, reply rate, AI summary, topic summaries, similar companies, verification flags. Charged as company-details per company.",
            "default": false
          },
          "includeTransparency": {
            "title": "Transparency report",
            "type": "boolean",
            "description": "Adds Trustpilot's transparency report (12-month stats, organic vs invited share, monthly counts, reports) to the company row. Same company-details charge.",
            "default": false
          },
          "monitorMode": {
            "title": "Skip delivered reviews (monitor)",
            "type": "boolean",
            "description": "Returns only reviews no earlier run with the same companies and filters delivered. A run cut short (e.g. at Max reviews per company) leaves older reviews that later runs deliver and charge, up to that cap per run. The company-details row, when on, comes and is charged every run.",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor memory name",
            "type": "string",
            "description": "Name of the key-value store that remembers delivered reviews. Use a different name per project.",
            "default": "trustpilot-reviews-monitor"
          },
          "maxReviewsPerCompany": {
            "title": "Max reviews per company",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "0 = every review the web pages reach. Trustpilot pages stop at 200 per list; past that the actor splits by language, star, review keyword, topic and sort.",
            "default": 100
          },
          "maxItems": {
            "title": "Max reviews per run",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Stop the whole run after this many reviews, across all companies. 0 = no run limit.",
            "default": 0
          },
          "compact": {
            "title": "Compact output",
            "type": "boolean",
            "description": "Core fields only (id, URL, rating, title, text, date, author, country, reply, company, input line) - sized for AI agents and MCP. Applies to review rows; the company-details row always comes whole.",
            "default": false
          },
          "fields": {
            "title": "Only these fields",
            "type": "array",
            "description": "Return only these fields, e.g. \"rating\", \"text\", \"publishedDate\". rowType, reviewId and input always stay (a restarted run needs them). Overrides compact. Empty = all fields. Applies to review rows; the company-details row always comes whole.",
            "items": {
              "type": "string"
            }
          },
          "textMaxLength": {
            "title": "Max text length",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Cut review text to this many characters. 0 = full text.",
            "default": 0
          },
          "excludeEmptyFields": {
            "title": "Drop empty fields",
            "type": "boolean",
            "description": "Leave out fields that are null, empty or an empty list.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Used when the direct connection fails, and from the first request if you pick proxy groups or your own proxies. Datacenter by default.",
            "default": {
              "useApifyProxy": true
            }
          },
          "maxConcurrency": {
            "title": "Pages in parallel",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many Trustpilot pages are read at the same time.",
            "default": 4
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}