{ "openapi": "3.0.1", "info": { "title": "Profound AI Alternative — Visibility Snapshots", "description": "Run bounded, source-labeled model API checks for a brand and named competitors. Export each AI-answer visibility snapshot as structured JSON for scheduled monitoring.", "version": "0.1", "x-build-id": "xWFCBF5N4hjOfv6rQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~profound-ai-alternative/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-profound-ai-alternative", "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/khadinakbar~profound-ai-alternative/runs": { "post": { "operationId": "runs-sync-khadinakbar-profound-ai-alternative", "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/khadinakbar~profound-ai-alternative/run-sync": { "post": { "operationId": "run-sync-khadinakbar-profound-ai-alternative", "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": [ "brandName", "prompts" ], "properties": { "brandName": { "title": "Brand name", "type": "string", "description": "The brand or product to look for in model answers, for example 'Example Analytics'. Use the precise public name customers recognize. This is not a competitor list or a domain; supply those in their separate fields." }, "prompts": { "title": "Prompts to check", "minItems": 1, "maxItems": 10, "type": "array", "description": "One to ten customer-style questions to send to each selected model API. Example: 'Which analytics platform is best for a small B2B SaaS team?'. These are supplied prompts, not observed consumer prompt-volume data.", "items": { "type": "string" } }, "brandDomain": { "title": "Brand domain", "type": "string", "description": "Optional primary website domain used to identify URLs in a returned answer that belong to the brand, for example 'example.com'. URLs and bare domains are accepted. This does not prove a model cited or ranked the domain outside the returned answer text." }, "competitors": { "title": "Named competitors", "maxItems": 10, "type": "array", "description": "Optional list of up to ten competitor names used for a simple answer-text share-of-voice calculation. Example: ['Rival Analytics', 'Another Analytics']. It does not discover competitors or estimate market share.", "items": { "type": "string" }, "default": [] }, "engines": { "title": "Model API engines", "type": "array", "description": "Choose the model APIs to query through the actor owner's managed provider. Valid values are 'openai', 'perplexity', and 'gemini'; the default is 'perplexity'. A model API response can differ from a consumer answer-engine product or its web-search experience.", "items": { "type": "string" }, "default": [ "perplexity" ] }, "maxResponses": { "title": "Maximum answer snapshots", "minimum": 1, "maximum": 30, "type": "integer", "description": "Hard cap on model-answer snapshots for this run. Each prompt × engine pair creates at most one billable persisted snapshot. Defaults to the smaller of ten or the supplied prompt count; this is not a token or output-row limit.", "default": 10 }, "responseFormat": { "title": "Answer detail", "enum": [ "concise", "detailed" ], "type": "string", "description": "Choose 'concise' for shorter model answers or 'detailed' for more response context. The actor stores the returned answer text together with its calculated visibility fields. This setting does not change the underlying model's factual accuracy.", "default": "concise" }, "dryRun": { "title": "Dry run", "type": "boolean", "description": "When enabled, validates the request and writes terminal run artifacts without contacting a model API or charging answer snapshots. Use it to test scheduling or integrations. It does not prove model availability or output quality.", "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 } } }, "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 } } } } } } } } } }