{ "openapi": "3.0.1", "info": { "title": "Google SERP Scraper & Rank Tracker + AI Overviews", "description": "Google SERP scraper and rank tracker for your domain and competitors on any keyword list. Daily positions, changes, visibility score, SERP features, AI Overview citations, landing URLs and an HTML report.", "version": "1.0", "x-build-id": "3csgKnPjPe5aLEX3I" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kirozhang~serp-rank-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kirozhang-serp-rank-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/kirozhang~serp-rank-tracker/runs": { "post": { "operationId": "runs-sync-kirozhang-serp-rank-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/kirozhang~serp-rank-tracker/run-sync": { "post": { "operationId": "run-sync-kirozhang-serp-rank-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": [ "myDomain", "keywords" ], "properties": { "myDomain": { "title": "Your domain", "type": "string", "description": "Required. The domain to track, e.g. example.com. Subdomains count as the same site." }, "keywords": { "title": "Keywords", "type": "array", "description": "Required. One keyword per line (up to 5,000 per run; 10 on the Apify free plan). Each keyword costs one charge per Google page checked.", "items": { "type": "string" } }, "competitorDomains": { "title": "Competitor domains", "type": "array", "description": "Optional. Competitor domains tracked on the same keywords, e.g. competitor.com.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "us", "gb", "ca", "au", "ie", "nz", "in", "de", "at", "ch", "fr", "be", "nl", "es", "it", "pt", "se", "dk", "no", "fi", "pl", "br", "mx", "ar", "jp", "sg", "ae", "za", "ph", "id" ], "type": "string", "description": "Google country (local Google domain + location).", "default": "us" }, "language": { "title": "Language", "enum": [ "en", "de", "fr", "es", "it", "nl", "pt", "sv", "da", "no", "fi", "pl", "ja", "id", "tl", "ar" ], "type": "string", "description": "Google interface / results language.", "default": "en" }, "depth": { "title": "Tracking depth", "enum": [ "10", "20", "30", "50", "100" ], "type": "string", "description": "How deep to look. Each 10 results is one Google page (one charge). The tracker stops early once all your tracked domains are found.", "default": "10" }, "trackingId": { "title": "Tracking name", "type": "string", "description": "Stable name for this project, e.g. 'example-us'. Runs with the same name are compared, which produces positionChange and trends. Defaults to your domain + country." }, "resolveUrls": { "title": "Landing page URLs", "enum": [ "tracked", "all", "none" ], "type": "string", "description": "Google hides exact result URLs; resolving them costs no extra charge but takes a moment.", "default": "tracked" } } }, "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 } } } } } } } } } }