{
"openapi": "3.0.1",
"info": {
"title": "Trustpilot Reviews API",
"description": "Scrape Trustpilot reviews, ratings, company replies and TrustScores for any company. Filter by stars, language, date range and keyword, or look companies up by name. No login, API key or proxy. Export data, run via API, schedule runs, or integrate with other tools or AI workflows.",
"version": "0.1",
"x-build-id": "mSbZ31Xt7VCMAHDXO"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/lergassy~trustpilot-reviews-api/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-lergassy-trustpilot-reviews-api",
"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/lergassy~trustpilot-reviews-api/runs": {
"post": {
"operationId": "runs-sync-lergassy-trustpilot-reviews-api",
"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/lergassy~trustpilot-reviews-api/run-sync": {
"post": {
"operationId": "run-sync-lergassy-trustpilot-reviews-api",
"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": {
"companies": {
"title": "⭐ Companies",
"type": "array",
"description": "Company domains or Trustpilot review URLs, one per line: slack.com, https://www.trustpilot.com/review/fiverr.com.",
"items": {
"type": "string"
}
},
"searchTerms": {
"title": "🔎 Search companies by name",
"type": "array",
"description": "Company names to look up on Trustpilot when you do not know the domain. Each term returns matching companies as search-result rows.",
"items": {
"type": "string"
}
},
"maxReviews": {
"title": "💯 Max reviews per company",
"minimum": 0,
"maximum": 100000,
"type": "integer",
"description": "How many reviews to collect for each company, newest first. Set 0 to collect company profiles only.",
"default": 100
},
"stars": {
"title": "Star ratings to include",
"type": "array",
"description": "Keep only reviews with these ratings. Leave empty for all. Pick 1 and 2 to collect complaints only.",
"items": {
"type": "string",
"enum": [
"1",
"2",
"3",
"4",
"5"
],
"enumTitles": [
"1 star",
"2 stars",
"3 stars",
"4 stars",
"5 stars"
]
}
},
"languages": {
"title": "Review language",
"type": "string",
"description": "Two-letter language code such as en, de, fr, or all for every language.",
"default": "en"
},
"dateRange": {
"title": "📅 Date range",
"enum": [
"",
"last30days",
"last3months",
"last6months",
"last12months"
],
"type": "string",
"description": "Only reviews from this period.",
"default": ""
},
"keyword": {
"title": "Keyword in review text",
"type": "string",
"description": "Keep only reviews that mention this word, for example refund."
},
"verifiedOnly": {
"title": "Verified reviews only",
"type": "boolean",
"description": "Keep only reviews Trustpilot marks as verified.",
"default": false
},
"withRepliesOnly": {
"title": "Reviews with a company reply only",
"type": "boolean",
"description": "Keep only reviews the company has answered.",
"default": false
},
"sort": {
"title": "Sort order",
"enum": [
"recency",
"relevance"
],
"type": "string",
"description": "Newest first, or Trustpilot's relevance order.",
"default": "recency"
},
"includeCompanyRow": {
"title": "Include a company profile row",
"type": "boolean",
"description": "Add one row per company with TrustScore, star rating, review counts, categories and claim status.",
"default": true
},
"maxSearchResults": {
"title": "Max companies per search term",
"minimum": 1,
"maximum": 100,
"type": "integer",
"description": "How many matching companies to return for each search term.",
"default": 10
},
"scrapeSearchResults": {
"title": "Also scrape reviews of search results",
"type": "boolean",
"description": "After a search, collect reviews for every company it found, using the limits above.",
"default": false
},
"maxConcurrency": {
"title": "⚡ Max concurrency",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "How many companies to scrape at the same time.",
"default": 4
},
"requestTimeoutSecs": {
"title": "⏱️ Request timeout (seconds)",
"minimum": 10,
"maximum": 300,
"type": "integer",
"description": "How long to wait for one page before giving up on it.",
"default": 45
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Optional. The Actor works without a proxy. Add one only if Trustpilot starts refusing your runs.",
"default": {
"useApifyProxy": 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
}
}
}
}
}
}
}
}
}
}