{ "openapi": "3.0.1", "info": { "title": "AI Visibility Tracker (GEO): ChatGPT, Gemini, Perplexity, Grok", "description": "Ask ChatGPT, Perplexity, Gemini, Claude and Grok, with live web search, the questions your buyers ask. See if your brand is named, its place in the list, the competitors named with it, how it is described, and the sites the AI cited.", "version": "0.1", "x-build-id": "zM293Cih9mMGpiFjP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/trueline-data~ai-search-visibility/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-trueline-data-ai-search-visibility", "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/trueline-data~ai-search-visibility/runs": { "post": { "operationId": "runs-sync-trueline-data-ai-search-visibility", "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/trueline-data~ai-search-visibility/run-sync": { "post": { "operationId": "run-sync-trueline-data-ai-search-visibility", "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": [ "prompts", "brand" ], "properties": { "prompts": { "title": "Questions your buyers ask", "type": "array", "description": "One question per line, written the way a buyer would type it into ChatGPT.", "items": { "type": "string" } }, "brand": { "title": "Your brand", "type": "string", "description": "The name to look for in the answers." }, "brandAliases": { "title": "Other names for your brand", "type": "array", "description": "Spellings that also count, like HousecallPro or HCP.", "items": { "type": "string" } }, "brandDomains": { "title": "Your websites", "type": "array", "description": "Domains like housecallpro.com. Used to tell you when the AI cites your own site as a source.", "items": { "type": "string" } }, "competitors": { "title": "Competitors", "type": "array", "description": "Names to track next to yours: who is named, in what order, and share of voice.", "items": { "type": "string" } }, "engines": { "title": "AI engines", "type": "array", "description": "Which assistants to ask. Each uses live web search.", "items": { "type": "string", "enum": [ "chatgpt", "perplexity", "gemini", "claude", "grok" ], "enumTitles": [ "ChatGPT", "Perplexity", "Gemini", "Claude", "Grok" ] }, "default": [ "chatgpt", "perplexity", "gemini" ] }, "runsPerPrompt": { "title": "Times to ask each question", "minimum": 1, "maximum": 5, "type": "integer", "description": "AI answers change from one ask to the next. Asking 3 times shows how often you are named, not just once.", "default": 1 }, "analyzeSentiment": { "title": "Judge how your brand is described", "type": "boolean", "description": "Positive, neutral or negative, with a short reason. Only for answers that name you.", "default": true }, "includeAnswerText": { "title": "Include the full answer", "type": "boolean", "description": "Keep the full text of every AI answer in the results. Turn off for smaller results.", "default": true }, "maxConcurrency": { "title": "Questions at the same time", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many answers to get at the same time. 5 is fine for most runs.", "default": 5 } } }, "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 } } } } } } } } } }