{ "openapi": "3.0.1", "info": { "title": "Personalisation Line Generator", "description": "One factual, campaign-ready opening line per company, grounded in that company's own website and quoted back to you. Lines we cannot ground come back as HOLD, and HOLD is free.", "version": "0.0", "x-build-id": "3RTZ944s5gAI0o1oL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cloudastra-technologies~personalisation-line-generator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cloudastra-technologies-personalisation-line-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/cloudastra-technologies~personalisation-line-generator/runs": { "post": { "operationId": "runs-sync-cloudastra-technologies-personalisation-line-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/cloudastra-technologies~personalisation-line-generator/run-sync": { "post": { "operationId": "run-sync-cloudastra-technologies-personalisation-line-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": [ "domains" ], "properties": { "domains": { "title": "Company domains", "minItems": 1, "maxItems": 60, "uniqueItems": true, "type": "array", "description": "1 to 60 companies, as domains (example.com). Full URLs work too, we strip them down. One line is produced per domain. Duplicate domains are collapsed before the run starts, so you are never charged twice for the same company.", "items": { "type": "string" } }, "style": { "title": "Line style", "enum": [ "observation" ], "type": "string", "description": "The sentence shape. One style is offered: an observation about what the company does, grounded in a sentence from its own website.", "default": "observation" }, "maxWords": { "title": "Maximum words per line", "minimum": 5, "maximum": 40, "type": "integer", "description": "5 to 40 words, default 18. This is a hard cap enforced after generation, not a suggestion to the model: a line over the cap is regenerated once and then held. Short caps raise the HOLD rate, because some companies cannot be described specifically in eight words.", "default": 18 }, "customContext": { "title": "What you are reaching out about", "maxLength": 300, "type": "string", "description": "Optional, up to 300 characters. One sentence about your own offer, used only to choose which true thing about the company to lead with. It tilts the angle, it never becomes a claim: nothing you write here can be asserted about the company, and every line is still grounded in a quote from their own site. Example: \"we sell compliance software to healthcare providers\" makes a line about their NHS work more likely than a line about their office move." }, "languages": { "title": "Accepted site languages", "uniqueItems": true, "type": "array", "description": "ISO 639-1 codes. A company whose site is not in one of these languages is held as wrong_language rather than translated, because a line written from a language we did not read is a line we cannot stand behind. Default is English only. Add codes to widen it.", "default": [ "en" ], "items": { "type": "string" } }, "preview": { "title": "Preview mode (small trial run)", "type": "boolean", "description": "Judge the quality on your own domains before committing. Processes only the first 10 domains, so a first run costs at most about $0.05. Same engine, same evidence, same rules, just fewer rows. This is a spend cap, not a free tier.", "default": false } } }, "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 } } } } } } } } } }