{ "openapi": "3.0.1", "info": { "title": "Google AI Mode Tracker - AI Mode API & Brand Visibility", "description": "AI SEO tool for Google AI Mode: run keywords through it and get the full generated answer, every cited source, and whether your brand is named or cited versus competitors. Share of voice, mention position, comparison tables. 18 countries. No API keys.", "version": "0.0", "x-build-id": "tlfdtuQYZtxwOp7wf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/santhej~google-ai-mode-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-santhej-google-ai-mode-tracker", "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/santhej~google-ai-mode-tracker/runs": { "post": { "operationId": "runs-sync-santhej-google-ai-mode-tracker", "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/santhej~google-ai-mode-tracker/run-sync": { "post": { "operationId": "run-sync-santhej-google-ai-mode-tracker", "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": [ "queries" ], "properties": { "queries": { "title": "Search queries", "type": "array", "description": "The queries to run through Google AI Mode. Unlike AI Overviews, AI Mode generates an answer for almost every query, so conversational and comparison prompts work well here.", "items": { "type": "string" } }, "brandName": { "title": "Your brand name", "type": "string", "description": "The brand to look for in the generated answer, e.g. HubSpot. Matched on whole words, case-insensitively." }, "brandAliases": { "title": "Brand aliases", "type": "array", "description": "Other ways your brand is written, e.g. product names or an abbreviation. Any of these counts as a mention.", "items": { "type": "string" } }, "brandDomains": { "title": "Your domains", "type": "array", "description": "Domains you own, e.g. hubspot.com. Used to detect whether AI Mode cited you as a source, which is separate from merely naming you.", "items": { "type": "string" } }, "competitorNames": { "title": "Competitor names", "type": "array", "description": "Competitor brands to count in the same answer. Used to compute your share of voice.", "items": { "type": "string" } }, "competitorDomains": { "title": "Competitor domains", "type": "array", "description": "Competitor domains, e.g. salesforce.com. Flags answers where a rival is cited as a source and you are not.", "items": { "type": "string" } }, "countryCode": { "title": "Country", "enum": [ "us", "gb", "ca", "au", "in", "de", "fr", "es", "it", "nl", "br", "mx", "jp", "sg", "ae", "za", "ie", "nz" ], "type": "string", "description": "Country to search from.", "default": "us" }, "languageCode": { "title": "Language", "type": "string", "description": "Two-letter interface language code (ISO 639-1).", "default": "en" }, "includeAnswerText": { "title": "Include the full AI Mode answer", "type": "boolean", "description": "Return the complete generated answer as markdown and plain text on every row. Turn off for a lighter dataset. Does not change the price.", "default": true } } }, "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 } } } } } } } } } }