{ "openapi": "3.0.1", "info": { "title": "AI Overview Rewrite Queue | Pages Losing Clicks to Google AI", "description": "SEO API that joins your Search Console export with Google AI Overview citation data and returns a scored, tiered rewrite queue. Finds the pages where you rank but a competitor is cited, ranks them by lost opportunity, and explains each call in one sentence. MCP-ready.", "version": "0.0", "x-build-id": "V15nKA2JJdva7hv1O" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnvc~ai-overview-rewrite-queue/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnvc-ai-overview-rewrite-queue", "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/johnvc~ai-overview-rewrite-queue/runs": { "post": { "operationId": "runs-sync-johnvc-ai-overview-rewrite-queue", "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/johnvc~ai-overview-rewrite-queue/run-sync": { "post": { "operationId": "run-sync-johnvc-ai-overview-rewrite-queue", "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": [ "target_domains" ], "properties": { "target_domains": { "title": "Your domains", "type": "array", "description": "Domains you consider yours, for example example.com. Each result is classified by whether any of these was cited in the AI Overview. Subdomains match their parent, so learn.example.com matches example.com. Enter a domain you own, not a public suffix like co.uk.", "items": { "type": "string" } }, "search_console_csv_url": { "title": "Search Console export URL (CSV)", "type": "string", "description": "URL of a Search Console Queries export with the standard Query, Clicks, Impressions, CTR and Position columns. In Google Sheets use File, Share, Publish to web and choose comma-separated values; a published Sheet URL lets scheduled runs pick up fresh data every time. Localized headers, semicolon delimiters and comma decimals are all handled." }, "search_console_rows": { "title": "Search Console rows (paste instead of a URL)", "type": "array", "description": "An alternative to the URL. Paste rows as JSON objects with query, clicks, impressions, ctr and position. Combined with the URL when both are given." }, "queries": { "title": "Extra keywords to check", "type": "array", "description": "Keywords to check on top of whatever the export contains. Leave empty to check exactly the queries in the export. Queries appearing in both are checked once.", "items": { "type": "string" } }, "min_impressions": { "title": "Minimum impressions", "minimum": 0, "type": "integer", "description": "Ignore export rows below this impression count. Raising it focuses the queue on queries with enough traffic to be worth a rewrite.", "default": 10 }, "gl": { "title": "Country code", "type": "string", "description": "Two-letter country code for the citation checks (ISO 3166-1, for example us, gb, ca). AI Overviews are available in a limited set of countries. Always set this deliberately: an unlogged region makes a lost citation indistinguishable from a different exit node.", "default": "us" }, "hl": { "title": "Language code", "type": "string", "description": "Two-letter interface language code (ISO 639-1, for example en). AI Overviews are currently shown for English searches, so en is recommended.", "default": "en" }, "location": { "title": "Location", "type": "string", "description": "Optionally narrow the citation checks to a named location, for example 'Austin, Texas, United States'. Leave empty to use country-level targeting from the country code." } } }, "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 } } } } } } } } } }