{
  "openapi": "3.0.1",
  "info": {
    "title": "Fast Trustpilot Reviews Scraper",
    "description": "Trustpilot reviews scraper - calls the site's data API directly. Full review text, verification, replies, and business profile (trust score, categories, contact info). Beast Mode digs deeper via multiple filter combos for max coverage (paid tier only).",
    "version": "0.1",
    "x-build-id": "ekZYSGGnl0UDXGAcU"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/mof1re~trustpilot-reviews-scraper-bypass-limit/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-mof1re-trustpilot-reviews-scraper-bypass-limit",
        "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/mof1re~trustpilot-reviews-scraper-bypass-limit/runs": {
      "post": {
        "operationId": "runs-sync-mof1re-trustpilot-reviews-scraper-bypass-limit",
        "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/mof1re~trustpilot-reviews-scraper-bypass-limit/run-sync": {
      "post": {
        "operationId": "run-sync-mof1re-trustpilot-reviews-scraper-bypass-limit",
        "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",
        "required": [
          "companies"
        ],
        "properties": {
          "companies": {
            "title": "Companies",
            "type": "array",
            "description": "One or more Trustpilot business identifiers (e.g. 'www.flashbay.com' or full company url 'https://www.trustpilot.com/review/www.flashbay.com'). Each is scraped in sequence.",
            "items": {
              "type": "string"
            }
          },
          "beastMode": {
            "title": "🔥 Beast Mode (Paid tier only)",
            "type": "boolean",
            "description": "Combines multiple filter strategies (star ratings, sort order, verification, replies, and topic-based searches) to dig past Trustpilot's standard pagination limit for maximum review coverage. Uses significantly more requests, so results are billed at a higher per-result rate. Not available on the free tier. Note: Beast Mode IGNORES all other filters including Max Results filter",
            "default": false
          },
          "maxResults": {
            "title": "Max reviews per company",
            "type": "integer",
            "description": "Maximum number of reviews to collect per company.",
            "default": 100
          },
          "stars": {
            "title": "⭐ Star rating",
            "type": "array",
            "description": "Filter reviews by star rating. Select one or more. Leave empty to include all ratings.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4",
                "5"
              ],
              "enumTitles": [
                "⭐ 1 Star",
                "⭐⭐ 2 Stars",
                "⭐⭐⭐ 3 Stars",
                "⭐⭐⭐⭐ 4 Stars",
                "⭐⭐⭐⭐⭐ 5 Stars"
              ]
            }
          },
          "sort": {
            "title": "🔀 Sort order",
            "enum": [
              "recency",
              "relevance"
            ],
            "type": "string",
            "description": "How reviews should be ordered.",
            "default": "recency"
          },
          "verified": {
            "title": "✅ Verified only",
            "type": "boolean",
            "description": "Only include reviews from verified reviewers.",
            "default": false
          },
          "replies": {
            "title": "💬 Business replied only",
            "type": "boolean",
            "description": "Only include reviews that received a reply from the business owner.",
            "default": false
          },
          "date": {
            "title": "📅 Date range",
            "enum": [
              "last30days",
              "last3months",
              "last6months",
              "last12months"
            ],
            "type": "string",
            "description": "Only include reviews published within this time range. Leave empty for all time."
          },
          "search": {
            "title": "🔎 Search keyword",
            "type": "string",
            "description": "Only include reviews whose text contains this keyword.",
            "default": ""
          },
          "matchKeyword": {
            "title": "🎯 Flag keyword matches (don't filter)",
            "type": "boolean",
            "description": "If enabled, all reviews are collected and each one gets a 'keyword_match' flag (true/false) based on the Search keyword below, instead of excluding non-matching reviews. If disabled, keyword filtering is skipped entirely and the flag stays null.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}