{ "openapi": "3.0.1", "info": { "title": "Call Score: AI Call Review & QA for Receptionists and Sales", "description": "Scores call recordings from a dataset, CSV or Google Sheet, keeping your columns: outcome, booked or not, lead quality, missed questions, 0 to 10 score and a speaker transcript. Inputs: recording links, businessContext, customQuestions. Charged per call minute. Agent-ready: x402, MCP.", "version": "0.1", "x-build-id": "vAubBmWdBvNMZAADD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nerolabs~call-score/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nerolabs-call-score", "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/nerolabs~call-score/runs": { "post": { "operationId": "runs-sync-nerolabs-call-score", "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/nerolabs~call-score/run-sync": { "post": { "operationId": "run-sync-nerolabs-call-score", "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": { "datasetId": { "title": "Dataset", "type": "string", "description": "An Apify dataset holding one row per call, for example a call log exported from your phone system or CRM. Every original column is kept (call ID, date, client, agent) and the score, outcome, missed opportunities and transcript are added alongside. Use the picker rather than typing an ID." }, "fileUrl": { "title": "File or Google Sheet URL", "type": "string", "description": "A public link to a CSV, TSV, Excel, JSON or JSON Lines file holding one row per call with a recording link (GoHighLevel, Vapi, Retell, Twilio, CallRail, Aircall or any phone system export). A normal Google Sheets link works: share it as 'Anyone with the link can view'." }, "fileFormat": { "title": "File format", "enum": [ "auto", "csv", "tsv", "json", "jsonl", "xlsx" ], "type": "string", "description": "Leave on 'Detect automatically' unless the link has no file extension and the server reports the wrong content type.", "default": "auto" }, "sheetName": { "title": "Excel sheet name", "type": "string", "description": "Which sheet to read from an Excel workbook. Defaults to the first sheet." }, "recordingUrls": { "title": "Call recording URLs", "type": "array", "description": "A plain list of direct links to call recordings (MP3, WAV, M4A, MP4 and more; Google Drive and Dropbox share links work), for a quick run with no spreadsheet. Use the dataset, file or Google Sheet inputs above to keep your own columns alongside each score.", "items": { "type": "string" } }, "data": { "title": "Rows", "type": "array", "description": "Rows as inline JSON, an alternative to a dataset or file. Each object needs a field holding the recording link." }, "urlField": { "title": "Recording URL field", "type": "string", "description": "The column holding the call recording link. Left empty it is detected automatically, preferring a column whose values end in .mp3, .wav or .m4a over one merely named 'url'." }, "businessContext": { "title": "About the business", "type": "string", "description": "A few lines on who answers these calls and what a good call looks like: the trade or business, area covered, services, whether prices are given on the phone, and what the receptionist should do (book a visit, take name, number and postcode, flag emergencies). The review judges every call against this. Left empty, the trade is inferred from each call." }, "customQuestions": { "title": "Custom questions", "type": "array", "description": "Up to 10 extra questions to answer for every call, for example 'Did the receptionist mention the free quote?' or 'Which competitor did the caller mention?'. Answers appear in 'customAnswers' and do not change the price.", "items": { "type": "string" } }, "language": { "title": "Language", "type": "string", "description": "Two-letter code of the spoken language (en, es, fr, de, pt, it, nl, pl, ja, zh and about 50 more). Leave empty to detect it automatically; setting it helps accuracy on short or noisy clips." }, "includeTranscript": { "title": "Include the transcript", "type": "boolean", "description": "Add the full call transcript, one line per speaker turn, so any score can be checked against what was actually said. Turn off for scores only.", "default": true }, "includeSegments": { "title": "Include timed segments", "type": "boolean", "description": "Speakers mode only. Adds a 'segments' array: one entry per speaker turn with speaker, start, end and text. Useful for feeding an AI agent or building your own player.", "default": false }, "maxMinutesPerFile": { "title": "Max minutes per file", "minimum": 1, "maximum": 600, "type": "integer", "description": "Only the first this-many minutes of each file are transcribed and charged. Your cost ceiling per file: a 6-hour livestream cannot run up a bill you did not expect.", "default": 120 }, "keep": { "title": "Which rows to keep", "enum": [ "all", "ok", "problems" ], "type": "string", "description": "Filtering happens after the call has been processed, so it does not make a run cheaper. 'Problems only' is the quick way to find broken recording links.", "default": "all" }, "keepOriginalFields": { "title": "Keep my original columns", "type": "boolean", "description": "Keep every column from the input row next to the score, so results line up with your own call log (call ID, date, client, agent). Turn off for review fields only.", "default": true }, "concurrency": { "title": "Files at a time", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many calls to work on in parallel. Reviews run on a remote service, so this is mostly limited by download speed; 3 suits the default memory.", "default": 3 }, "requestTimeoutSecs": { "title": "Download timeout", "minimum": 5, "maximum": 600, "type": "integer", "description": "How long to wait for one file to download before giving up on it. A timed-out file is never charged.", "default": 120 }, "maxFileMb": { "title": "Largest file", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Files bigger than this are skipped and not charged. Video files are large; only their audio is used.", "default": 500 }, "maxItems": { "title": "Maximum files", "minimum": 1, "maximum": 50000, "type": "integer", "description": "A hard ceiling on how many rows are read from the input, as a safety net on a large dataset." }, "exportFormats": { "title": "Export files", "type": "array", "description": "Also write the results as a real downloadable CSV or Excel file, linked from the run's output. List fields are joined with semicolons so they fit a spreadsheet.", "items": { "type": "string", "enum": [ "csv", "xlsx" ], "enumTitles": [ "CSV", "Excel (xlsx)" ] }, "default": [] }, "outputDatasetName": { "title": "Append to named dataset", "type": "string", "description": "Also append every kept row to a named dataset that persists across runs, building one growing call history. Not charged again." }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "POST the run summary to this URL when the run finishes, for Slack, Zapier, Make, n8n or your own API. Charged only on a confirmed 2xx response." } } }, "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 } } } } } } } } } }