{ "openapi": "3.0.1", "info": { "title": "Google AI Mode Ads Tracker: Who Advertises in AI Mode", "description": "Shows which ads Google puts inside AI Mode answers for your keywords, per country: advertiser, headline, description, sitelinks, new-ad alerts. Input: keywords (list, dataset, CSV or Sheet) and countries. $0.003 per keyword checked, $0.02 per ad found; no answer free. Agent-ready via x402 and MCP.", "version": "0.1", "x-build-id": "pr9NWoht4e72BGTft" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nerolabs~google-ai-mode-ads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nerolabs-google-ai-mode-ads", "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/nerolabs~google-ai-mode-ads/runs": { "post": { "operationId": "runs-sync-nerolabs-google-ai-mode-ads", "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/nerolabs~google-ai-mode-ads/run-sync": { "post": { "operationId": "run-sync-nerolabs-google-ai-mode-ads", "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", "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "Search terms to check, one per line, for example 'best vpn deal' or 'cheap car insurance quote'. Each keyword is checked once in every country you pick. Leave empty to read keywords from a dataset, file or Google Sheet instead.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Where to search from. Google switched on ads in AI Mode in these ten countries on 28-10-2026: Australia, Canada, India, Kenya, Malaysia, New Zealand, Nigeria, Pakistan, the Philippines and Singapore. The UK, Brazil and Mexico are planned for Q4 2026.", "items": { "type": "string", "enum": [ "au", "ca", "in", "ke", "my", "nz", "ng", "pk", "ph", "sg", "us", "gb", "br", "mx" ], "enumTitles": [ "Australia (ads live 28-10-2026)", "Canada (ads live 28-10-2026)", "India (ads live 28-10-2026)", "Kenya (ads live 28-10-2026)", "Malaysia (ads live 28-10-2026)", "New Zealand (ads live 28-10-2026)", "Nigeria (ads live 28-10-2026)", "Pakistan (ads live 28-10-2026)", "Philippines (ads live 28-10-2026)", "Singapore (ads live 28-10-2026)", "United States", "United Kingdom (ads planned Q4 2026)", "Brazil (ads planned Q4 2026)", "Mexico (ads planned Q4 2026)" ] }, "default": [ "au" ] }, "watchMode": { "title": "Watch mode: mark new ads", "type": "boolean", "description": "Remember every ad found under this watch list name, so each later run marks which ads are new (isNew, firstSeenAt). Schedule the run daily or weekly to see when competitors start or stop advertising in AI Mode.", "default": false }, "watchListName": { "title": "Watch list name", "type": "string", "description": "Keep one name per client or project. Runs with the same name share their memory of ads already seen.", "default": "default" }, "onlyNewAds": { "title": "Return only new ads", "type": "boolean", "description": "With watch mode on, return (and charge for) only ads not seen before in this watch list. Every keyword checked is still listed and charged once.", "default": false }, "datasetId": { "title": "Dataset", "type": "string", "description": "An Apify dataset holding keywords, for example the output of a keyword research actor. Used when 'Keywords' is empty." }, "fileUrl": { "title": "File or Google Sheet URL", "type": "string", "description": "A public link to a CSV, TSV, Excel, JSON or JSON Lines file with one keyword per row. A normal Google Sheets link works when shared as 'Anyone with the link can view'. Used when 'Keywords' and 'Dataset' are empty." }, "fileFormat": { "title": "File format", "enum": [ "auto", "csv", "tsv", "json", "jsonl", "xlsx" ], "type": "string", "description": "Leave on 'Detect automatically' unless the link has no file extension.", "default": "auto" }, "sheetName": { "title": "Excel sheet name", "type": "string", "description": "Only for Excel files with several sheets. Leave empty for the first sheet." }, "keywordField": { "title": "Keyword column", "type": "string", "description": "The column that holds the search terms. Leave empty to use a column named keyword, query, search term or term, else the first text column." }, "splitAdText": { "title": "Split ads into advertiser, headline and description", "type": "boolean", "description": "A small AI model copies the advertiser, headline and description out of each ad's text. Every part is checked word for word against the ad, so nothing is invented. The full ad text is always returned too.", "default": true }, "maxKeywords": { "title": "Maximum keywords", "minimum": 1, "maximum": 2000, "type": "integer", "description": "A safety cap on how many keywords one run checks (each is checked once per country).", "default": 500 } } }, "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 } } } } } } } } } }