{ "openapi": "3.0.1", "info": { "title": "Personalized Outreach Video Generator – AI Voice Clone", "description": "One recording. Hundreds of personalized videos. An AI voice clone greets each prospect by name, lip-synced, their website on screen. Built for cold email and LinkedIn outreach and video prospecting. $1.25 per delivered video, $0.99 on Business. Failed or degraded renders are never charged.", "version": "0.1", "x-build-id": "O9WHTt2SORqEkI0Kk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/outvo~personalized-outreach-video-generator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-outvo-personalized-outreach-video-generator", "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/outvo~personalized-outreach-video-generator/runs": { "post": { "operationId": "runs-sync-outvo-personalized-outreach-video-generator", "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/outvo~personalized-outreach-video-generator/run-sync": { "post": { "operationId": "run-sync-outvo-personalized-outreach-video-generator", "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": [ "videoUrl", "placeholderWord" ], "properties": { "videoUrl": { "title": "Your recording", "type": "string", "description": "Public or signed URL of your recorded MP4 (max 200 MB). Record yourself once saying a greeting with a placeholder name — e.g. 'Hey there, I loved what you're building.' Outvo clones the greeting for every recipient. The same URL is reused across runs without re-uploading." }, "placeholderWord": { "title": "Placeholder word", "type": "string", "description": "The word in your recording that gets replaced with each recipient's first name. If you said 'Hey there', enter `there`. The sample recording prefilled above says `avocado`, so leave it as-is to try the Actor before recording your own.", "default": "there" }, "recipients": { "title": "Recipients", "type": "array", "description": "Recipients as JSON: `[{ \"firstName\": \"Sarah\", \"company\": \"Acme\", \"url\": \"https://acme.com\" }]`. Leave empty when chaining from another Actor with Input dataset below. `url` is each recipient's website or LinkedIn page, shown on screen next to your video." }, "inputDatasetId": { "title": "Input dataset", "type": "string", "description": "Dataset from a previous Actor run (e.g. a LinkedIn or Google Maps scraper). Chain it here and every row becomes a personalized video — map the columns with Field mapping below." }, "fieldMapping": { "title": "Field mapping", "type": "object", "description": "Which dataset columns feed the video: keys are Outvo fields (`firstName`, `company`, `url`, `title`, `language`, `pronunciation`), values are your dataset's column names. Dot paths supported (`contact.first_name`).", "default": { "firstName": "firstName", "company": "companyName", "url": "websiteUrl" } }, "pipLayout": { "title": "Website overlay position", "enum": [ "bottom-right", "bottom-left", "side-panel", "none" ], "type": "string", "description": "Where the recipient's website recording appears over your video. `none` = talking-head only (recipient `url` becomes optional).", "default": "bottom-right" }, "pipDurationSeconds": { "title": "Website overlay duration (seconds)", "minimum": 0, "maximum": 60, "type": "integer", "description": "How long the website recording stays on screen.", "default": 8 }, "recordingMode": { "title": "Website recording layout", "enum": [ "desktop", "mobile" ], "type": "string", "description": "Capture the recipient's website as desktop or mobile layout.", "default": "desktop" }, "missingUrlBehavior": { "title": "Rows with no website URL", "enum": [ "skip", "renderWithoutPip" ], "type": "string", "description": "What to do with rows that have no `url` while a website overlay is enabled: skip them (never charged, reported in the output) or render them as talking-head-only videos.", "default": "skip" }, "maxVideos": { "title": "Maximum videos this run", "minimum": 1, "maximum": 200, "type": "integer", "description": "Safety cap for this run. You are only charged for videos actually delivered — failed or degraded videos are always free.", "default": 25 }, "outvoApiKey": { "title": "Your own Outvo API key (optional)", "type": "string", "description": "Optional. Paste your own Outvo API key (outvo.io → Settings → API Keys) to render against your Outvo plan instead of paying per video here." } } }, "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 } } } } } } } } } }