{ "openapi": "3.0.1", "info": { "title": "Review Theme Analyzer: Praise and Complaint Themes", "description": "Turn any review dataset into ranked praise and complaint themes with counts, representative quotes, and per location or per product breakdowns. Works on the output of the big review scrapers. Deterministic local analysis, no AI API cost.", "version": "0.0", "x-build-id": "EhEy1FEO4PNmyFQJI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/delta_tools~review-theme-analyzer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-delta_tools-review-theme-analyzer", "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/delta_tools~review-theme-analyzer/runs": { "post": { "operationId": "runs-sync-delta_tools-review-theme-analyzer", "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/delta_tools~review-theme-analyzer/run-sync": { "post": { "operationId": "run-sync-delta_tools-review-theme-analyzer", "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": { "apifyApiToken": { "title": "Your Apify API token (only for dataset ID input)", "type": "string", "description": "Your own Apify API token, needed only when you use a dataset ID and your account restricts storage access (the run then cannot read the dataset on its own). The token is a secret input, is used once to read that one dataset from api.apify.com, and is never stored in the output. Leave empty when you paste reviews inline." }, "datasetId": { "title": "Dataset ID with reviews", "type": "string", "description": "The Apify dataset that holds the reviews, for example the output dataset of a Google Maps or Amazon review scraper. Paste its dataset ID. Leave empty when you paste reviews below instead." }, "groupField": { "title": "Group field (optional)", "type": "string", "description": "Optional record field that names a group, such as a location, a store, or a product name. When set, the output adds one breakdown record per group with its own counts and top themes. The sample input uses location." }, "inlineReviews": { "title": "Inline reviews (optional)", "type": "array", "description": "Reviews pasted directly as a JSON array. Each item is an object with a review text field, or a plain text string. The sample below analyzes in seconds and shows the full output shape." }, "maxReviews": { "title": "Max reviews to analyze", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of reviews to analyze in one run. You are charged only for reviews actually analyzed, so a cap is also a spend cap.", "default": 2000 }, "ratingField": { "title": "Rating field", "type": "string", "description": "Record field that holds a star rating from 1 to 5, when the dataset has one. Ratings anchor the praise and complaint sorting. Records without a rating are scored from their words alone.", "default": "rating" }, "textField": { "title": "Review text field", "type": "string", "description": "Record field that holds the review text. Common names such as review, comment, and feedback are also found automatically when this field is empty on a record.", "default": "text" } } }, "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 } } } } } } } } } }