{ "openapi": "3.0.1", "info": { "title": "Trustpilot Reviews Scraper - All Reviews, Company & Categories", "description": "Scrape all Trustpilot reviews (no 200-review cap) with star, date, language, topic and verified filters, plus company details, categories, reviewer profiles and a 89k-company insights database.", "version": "0.1", "x-build-id": "ki7tk0o0oyEfsZtEk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/eduair94~trustpilot-full-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-eduair94-trustpilot-full-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/eduair94~trustpilot-full-api/runs": { "post": { "operationId": "runs-sync-eduair94-trustpilot-full-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/eduair94~trustpilot-full-api/run-sync": { "post": { "operationId": "run-sync-eduair94-trustpilot-full-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "reviews", "reviews_filtered", "review_count", "company_details", "company_intelligence", "domain_intelligence", "tripadvisor_search", "tripadvisor_reviews", "app_store_reviews", "google_play_reviews", "crawl4ai_enrichment", "category_companies", "category_recent", "category_newest", "category_details", "consumer", "consumer_reviews", "search_business", "search_category", "suggestions", "categories_all", "semantic_suggestions", "insights_companies", "insights_top", "insights_facets", "insights_company_stats" ], "type": "string", "description": "Which Trustpilot or business-intelligence dataset to pull.", "default": "reviews" }, "domains": { "title": "Company domains", "type": "array", "description": "One or more company domains, e.g. nike.com. Used by review, company, domain-intelligence, and Crawl4AI modes.", "items": { "type": "string" } }, "domain": { "title": "Associated Trustpilot domain", "type": "string", "description": "Optional single Trustpilot domain used to link Tripadvisor, App Store, or Google Play results to the company in MongoDB." }, "categoryId": { "title": "Category ID", "type": "string", "description": "Trustpilot category id/slug (e.g. bank). Used by category_* and category_details." }, "consumerIds": { "title": "Consumer IDs", "type": "array", "description": "Trustpilot consumer profile IDs. Used by consumer / consumer_reviews.", "items": { "type": "string" } }, "businessUnitId": { "title": "Business Unit ID", "type": "string", "description": "Used by insights_company_stats." }, "query": { "title": "Search query", "type": "string", "description": "Used by search_business / search_category / suggestions / insights_companies and as a fallback for tripadvisor_search." }, "intelligence": { "title": "Full company intelligence", "type": "boolean", "description": "Request domain intelligence, relevant Tripadvisor discovery, app discovery, cross-source comparisons, topics, and alerts. company_intelligence enables this automatically." }, "domainIntel": { "title": "Domain intelligence", "type": "boolean", "description": "Include normalized RDAP/WHOIS and website trust signals in company_intelligence." }, "whois": { "title": "WHOIS alias", "type": "boolean", "description": "Alias that enables domain intelligence. RDAP is preferred with native WHOIS fallback." }, "rdap": { "title": "RDAP alias", "type": "boolean", "description": "Alias that enables domain intelligence. RDAP is preferred with native WHOIS fallback." }, "registrationOnly": { "title": "Registration only", "type": "boolean", "description": "Skip DNS, TLS, HTTP, email-security, and security-header inspection when collecting domain intelligence." }, "tripadvisor": { "title": "Enable Tripadvisor", "type": "boolean", "description": "Enable Tripadvisor discovery and review enrichment for company_intelligence." }, "tripadvisorQuery": { "title": "Tripadvisor search query", "type": "string", "description": "Business name plus city or country for tripadvisor_search." }, "tripadvisorUrl": { "title": "Tripadvisor URL", "type": "string", "description": "Exact Tripadvisor hotel, restaurant, attraction, or airline review URL." }, "tripadvisorId": { "title": "Tripadvisor location ID", "type": "integer", "description": "Exact Tripadvisor location ID. In tripadvisor_reviews, the Actor auto-resolves its canonical URL and entity type when neither is supplied." }, "tripadvisorGeoId": { "title": "Tripadvisor geographic ID", "type": "integer", "description": "Optional Tripadvisor geographic ID used with an explicit location ID." }, "tripadvisorType": { "title": "Tripadvisor entity type", "enum": [ "HOTEL", "RESTAURANT", "ATTRACTION", "AIRLINE" ], "type": "string", "description": "Optional entity type for an explicit location ID. Supplying it skips automatic ID discovery in tripadvisor_reviews." }, "tripadvisorLimit": { "title": "Tripadvisor review limit", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum Tripadvisor reviews to return, from 1 to 200.", "default": 20 }, "noTripadvisorDiscovery": { "title": "Disable Tripadvisor discovery", "type": "boolean", "description": "Use only explicit or previously stored Tripadvisor mappings; do not search automatically." }, "appStore": { "title": "Enable Apple App Store", "type": "boolean", "description": "Enable free public Apple App Store metadata and review enrichment." }, "appStoreAppId": { "title": "Apple App Store ID", "type": "string", "description": "Numeric Apple app ID or an App Store URL containing the ID." }, "appStoreCountry": { "title": "Apple storefront country", "type": "string", "description": "Two-letter App Store country or storefront code, default us.", "default": "us" }, "googlePlay": { "title": "Enable Google Play", "type": "boolean", "description": "Enable the free public Google Play store integration. No paid Google API is required." }, "googlePlayAppId": { "title": "Google Play app ID", "type": "string", "description": "Android package ID or Google Play app URL." }, "googlePlayLanguage": { "title": "Google Play language", "type": "string", "description": "Two-letter language code for Google Play content, default en.", "default": "en" }, "googlePlayCountry": { "title": "Google Play country", "type": "string", "description": "Two-letter Google Play country or storefront code, default us.", "default": "us" }, "googlePlayLimit": { "title": "Google Play review limit", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum recent Google Play reviews to return, from 1 to 500.", "default": 100 }, "crawl4ai": { "title": "Enable Crawl4AI", "type": "boolean", "description": "Enable structured website enrichment through the configured Crawl4AI service." }, "crawlMaxPages": { "title": "Crawl4AI page limit", "minimum": 1, "maximum": 8, "type": "integer", "description": "Maximum selected website pages Crawl4AI may process, from 1 to 8.", "default": 5 }, "companyName": { "title": "Expected company name", "type": "string", "description": "Optional expected company name used to improve Crawl4AI identity-match confidence." }, "includeTopics": { "title": "Include review topics", "type": "boolean", "description": "Build normalized positive and negative review topics across available sources." }, "refresh": { "title": "Refresh cached enrichment", "type": "boolean", "description": "Bypass reusable domain-intelligence and Crawl4AI caches where applicable." }, "noPersist": { "title": "Do not persist", "type": "boolean", "description": "Skip review, website-enrichment, profile-mapping, and business-intelligence snapshot writes for this request." }, "countryCode": { "title": "Country code", "type": "string", "description": "ISO country code for semantic_suggestions (e.g. US)." }, "stars": { "title": "Star filter", "type": "array", "description": "Reviews filter: 1-5 (multi-select).", "items": { "type": "string" } }, "date": { "title": "Date range", "type": "string", "description": "Reviews filter: all / last30days / last3months / last6months / last12months." }, "languages": { "title": "Languages", "type": "array", "description": "Reviews filter: ISO language codes (e.g. en, de). Empty = all.", "items": { "type": "string" } }, "topics": { "title": "Topics", "type": "array", "description": "Reviews filter: topic slugs.", "items": { "type": "string" } }, "aspects": { "title": "Aspects", "type": "array", "description": "Reviews filter: aspect slugs.", "items": { "type": "string" } }, "search": { "title": "In-review search", "type": "string", "description": "Reviews filter: free-text within reviews." }, "verified": { "title": "Verified only", "type": "boolean", "description": "Reviews/insights filter." }, "replies": { "title": "With replies only", "type": "boolean", "description": "Reviews filter: only reviews the company has replied to." }, "sort": { "title": "Sort", "type": "string", "description": "Reviews sort (recency / relevance)." }, "country": { "title": "Country", "type": "string", "description": "Category/search country filter." }, "trustScore": { "title": "TrustScore filter", "type": "array", "description": "Category filter: trust score buckets.", "items": { "type": "string" } }, "subcategories": { "title": "Subcategories", "type": "array", "description": "Category filter: subcategory slugs to narrow a category browse.", "items": { "type": "string" } }, "claimed": { "title": "Claimed only", "type": "boolean", "description": "Category filter: only companies that have claimed their profile." }, "perPage": { "title": "Results per page", "type": "integer", "description": "search_business: number of results per page." }, "sortBy": { "title": "Sort by", "type": "string", "description": "search_business / insights: field to sort results by." }, "category": { "title": "Insights category filter", "type": "string", "description": "insights_companies: restrict the corpus query to a category id." }, "minTrustScore": { "title": "Min TrustScore", "type": "integer", "description": "insights_companies: minimum TrustScore (0-5)." }, "maxTrustScore": { "title": "Max TrustScore", "type": "integer", "description": "insights_companies: maximum TrustScore (0-5)." }, "minReviews": { "title": "Min reviews", "type": "integer", "description": "insights: minimum review count." }, "maxReviews": { "title": "Max reviews", "type": "integer", "description": "insights_companies: maximum review count." }, "order": { "title": "Order", "type": "string", "description": "insights_companies: sort order, asc or desc." }, "limit": { "title": "Result limit (insights)", "type": "integer", "description": "insights_companies / insights_top: max results per page." }, "raw": { "title": "Raw upstream payload", "type": "boolean", "description": "categories_all / semantic_suggestions: return upstream shape verbatim." }, "page": { "title": "Start page", "type": "integer", "description": "First page to fetch (default 1)." }, "maxItems": { "title": "Max results", "type": "integer", "description": "Stop after this many results (default 100).", "default": 100 }, "maxPages": { "title": "Max pages", "type": "integer", "description": "Safety cap on pagination (default 50).", "default": 50 } } }, "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 } } } } } } } } } }