{ "openapi": "3.0.1", "info": { "title": "Bulk Text Classifier", "description": "Classify texts in bulk from CSV, JSON or pasted lists. Add your own labels for sentiment analysis, topics, support tickets and customer feedback. Choose one or multiple labels per text and export clean results. Use with Claude, Codex or Cursor through Apify.", "version": "1.2", "x-build-id": "QcT1K6CQNhD3uiJ8Y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lofomachines~bulk-text-classifier/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lofomachines-bulk-text-classifier", "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/lofomachines~bulk-text-classifier/runs": { "post": { "operationId": "runs-sync-lofomachines-bulk-text-classifier", "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/lofomachines~bulk-text-classifier/run-sync": { "post": { "operationId": "run-sync-lofomachines-bulk-text-classifier", "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": [ "context", "labels" ], "properties": { "source": { "title": "Where are your texts?", "enum": [ "texts", "file" ], "type": "string", "description": "Choose Paste texts for a list, or Upload CSV / JSON for a file. Only the selected source is used.", "default": "texts" }, "texts": { "title": "Texts to classify", "type": "array", "description": "Add one text per item. Use Bulk edit to paste one text per line. For reviews containing line breaks, use a CSV or JSON file. Only used when Paste texts is selected.", "items": { "type": "string" } }, "file": { "title": "Upload your CSV or JSON file", "type": "string", "description": "Only for Upload CSV / JSON. Upload a UTF-8 file up to 20 MB, or provide a downloadable HTTPS link. CSV needs a header row. JSON must be an array of objects, such as [{\"review\":\"Great service\"}]." }, "textField": { "title": "Text column / JSON key (exact name)", "type": "string", "description": "Required for files. Enter the exact CSV column name or JSON key, including capitals and spaces. Example: review for [{\"review\":\"Great service\"}]. Only top-level JSON keys are supported; dots are literal characters, not nested paths." }, "context": { "title": "What do you want to classify?", "minLength": 1, "maxLength": 2000, "type": "string", "description": "Explain the goal in everyday language. Examples: Analyze the sentiment; Sort support tickets by department; Identify the topics discussed. You can explain what your labels mean here." }, "labels": { "title": "Your classification labels", "minItems": 2, "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Add 2–50 different labels. Example: positive, neutral, negative (one per item). Results use these exact labels after removing leading/trailing spaces. For unclear texts, add a label such as other and describe it in your goal.", "items": { "type": "string" } }, "multiLabel": { "title": "Allow multiple labels per text", "type": "boolean", "description": "Off: choose one best label per text. On: return all matching labels up to your maximum. For topic tagging, a text can be both pricing and delivery. No matching label returns an empty list.", "default": false }, "maxLabels": { "title": "Maximum labels per text", "minimum": 1, "maximum": 50, "type": "integer", "description": "Only used when multiple labels are enabled. Example: 3 allows zero, one, two or three matching labels. This is a maximum, not a target. If you provide fewer labels, that smaller number is the limit.", "default": 3 } } }, "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 } } } } } } } } } }