{ "openapi": "3.0.1", "info": { "title": "Trustpilot Rating Star Breakdown and Review Count Enricher", "description": "Returns the Trustpilot TrustScore, star score, total review count and the full one to five star breakdown, read from Trustpilot own public TrustBox data endpoint. No API key. Takes a Trustpilot business unit id, or a domain when the company publishes its id on its own site.", "version": "0.3", "x-build-id": "yz15kyf4ZlQ6HIiV0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mambalabs~review-platform-reputation-enricher/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mambalabs-review-platform-reputation-enricher", "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/mambalabs~review-platform-reputation-enricher/runs": { "post": { "operationId": "runs-sync-mambalabs-review-platform-reputation-enricher", "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/mambalabs~review-platform-reputation-enricher/run-sync": { "post": { "operationId": "run-sync-mambalabs-review-platform-reputation-enricher", "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": { "company_domain": { "title": "Company Domain", "type": "string", "description": "Bare company domain, for example monzo.com. Used to look for a Trustpilot business unit id in that company own widget embed. Supplying trustpilotBusinessUnitId instead skips this step and always resolves." }, "company_name": { "title": "Company Name", "type": "string", "description": "Optional. Carried through to the output row for joining. The lookup is keyed on the business unit id, so the name never changes which business is returned." }, "publicPageAccess": { "title": "Public Page Access (advanced, off by default)", "enum": [ "off", "unblocker" ], "type": "string", "description": "Leave at \"off\" (default) and this actor reads only Trustpilot public TrustBox data endpoint, which Trustpilot robots.txt explicitly allows. Set to \"unblocker\" and it will instead read Trustpilot public company pages through Apify Unblocker, which resolves any domain with no business unit id and also returns categories, claimed status and verification. Two things to know before you set it: Trustpilot robots.txt disallows those pages to automated agents, so this is your call and not a default, and it spends Unblocker units from your own Apify account. Every row records trustpilot_route, so your dataset always says which route produced it. Sent as a string for Clay compatibility.", "default": "off" }, "trustpilotBusinessUnitId": { "title": "Trustpilot Business Unit ID", "type": "string", "description": "The 24 character Trustpilot business unit id, for example 57da77be0000ff000594bcdb. This is the fastest and most reliable input: supplied here it always resolves. Find it in the page source of any site running a Trustpilot widget, as data-businessunit-id. Leave it empty and the actor looks for it on the company own site." }, "minReviewCount": { "title": "Minimum Review Count", "enum": [ "none", "10", "50", "100", "500" ], "type": "string", "description": "Sets rating_is_meaningful on the row. A 5.0 rating from two reviews and a 4.2 from nine hundred are not comparable numbers, and this is the column that says which one you are looking at. It never drops a row and never changes the rating returned. Sent as a string for Clay compatibility.", "default": "none" }, "includeCategories": { "title": "Include Categories", "enum": [ "true", "false" ], "type": "string", "description": "Has no effect in this version. Trustpilot publishes a business categories only on its public company page, and that page is disallowed to us by Trustpilot own robots.txt, so trustpilot_categories is null on every row and trustpilot_categories_status says not_extractable. The setting is kept so saved configurations keep working. Sent as a string for Clay compatibility.", "default": "true" }, "sources": { "title": "Sources", "enum": [ "trustpilot" ], "type": "string", "description": "Which review sources to query. This version serves Trustpilot only. G2, Capterra and Glassdoor appear as columns and always report skipped, with the reason on the row, because all three refused every documented route and none publishes an API we can use as documented. This setting exists so a saved configuration keeps working when a source is added. Sent as a string for Clay compatibility.", "default": "trustpilot" }, "skipCache": { "title": "Skip Cache", "enum": [ "false", "true" ], "type": "string", "description": "When \"false\" (default) a successful lookup is cached for seven days and reused, which costs you nothing on a repeated run. Set \"true\" to force a fresh fetch. Sent as a string for Clay compatibility.", "default": "false" }, "source_tag": { "title": "Source Tag", "type": "string", "description": "Internal attribution tag set by Mamba Labs on published task examples. Not required, and nothing depends on it. Leave it empty." } } }, "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 } } } } } } } } } }