{ "openapi": "3.0.1", "info": { "title": "Google AI Overview Tracker: Brand Mentions & Citations", "description": "Google's AI Overview for your keywords in 50 countries: the full answer (incl. Show more), every cited site with its real URL, and whether your brands are named or cited. $0.01 per AI Overview; keywords without one are free.", "version": "0.1", "x-build-id": "3uDOg5ntTaS9IQELb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zaiq~google-ai-overview-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zaiq-google-ai-overview-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/zaiq~google-ai-overview-tracker/runs": { "post": { "operationId": "runs-sync-zaiq-google-ai-overview-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/zaiq~google-ai-overview-tracker/run-sync": { "post": { "operationId": "run-sync-zaiq-google-ai-overview-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": [ "keywords" ], "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "Searches or questions, one per line, as people type them into Google.", "items": { "type": "string" } }, "brands": { "title": "Brands to track", "type": "array", "description": "One per line: a brand name, a domain, or both as 'Name | domain.com'. Each AI Overview is checked for whether the brand is named and whether its site is cited.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Each keyword is searched on Google as a signed-out searcher in each of these countries.", "items": { "type": "string", "enum": [ "US", "GB", "CA", "AU", "NZ", "IE", "IN", "ZA", "DE", "AT", "CH", "FR", "BE", "NL", "ES", "PT", "IT", "SE", "NO", "DK", "FI", "PL", "CZ", "RO", "GR", "HU", "TR", "UA", "IL", "AE", "SA", "EG", "NG", "KE", "JP", "KR", "TW", "HK", "SG", "MY", "ID", "PH", "TH", "VN", "PK", "BR", "MX", "AR", "CL", "CO" ], "enumTitles": [ "United States (US)", "United Kingdom (GB)", "Canada (CA)", "Australia (AU)", "New Zealand (NZ)", "Ireland (IE)", "India (IN)", "South Africa (ZA)", "Germany (DE)", "Austria (AT)", "Switzerland (CH)", "France (FR)", "Belgium (BE)", "Netherlands (NL)", "Spain (ES)", "Portugal (PT)", "Italy (IT)", "Sweden (SE)", "Norway (NO)", "Denmark (DK)", "Finland (FI)", "Poland (PL)", "Czechia (CZ)", "Romania (RO)", "Greece (GR)", "Hungary (HU)", "Turkey (TR)", "Ukraine (UA)", "Israel (IL)", "United Arab Emirates (AE)", "Saudi Arabia (SA)", "Egypt (EG)", "Nigeria (NG)", "Kenya (KE)", "Japan (JP)", "South Korea (KR)", "Taiwan (TW)", "Hong Kong (HK)", "Singapore (SG)", "Malaysia (MY)", "Indonesia (ID)", "Philippines (PH)", "Thailand (TH)", "Vietnam (VN)", "Pakistan (PK)", "Brazil (BR)", "Mexico (MX)", "Argentina (AR)", "Chile (CL)", "Colombia (CO)" ] }, "default": [ "US" ] }, "language": { "title": "Language (optional)", "type": "string", "description": "Language of Google's results, e.g. en, de, fr, pt-BR. Empty: each country's usual language (English for the US, UK, India, South Africa...)." }, "maxConcurrency": { "title": "Searches at once", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many Google searches run at the same time.", "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 } } } } } } } } } }