{ "openapi": "3.0.1", "info": { "title": "SERP Rank Tracker Lite", "description": "Track Google, Bing, and DuckDuckGo rankings for any keyword/domain with native AI Overview detection. Pay-per-keyword alternative to Ahrefs, SEMrush, and SE Ranking for SEO freelancers and agencies.", "version": "0.0", "x-build-id": "SESWqf5iuXMxEFytA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexgendata~serp-rank-tracker-lite/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexgendata-serp-rank-tracker-lite", "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/nexgendata~serp-rank-tracker-lite/runs": { "post": { "operationId": "runs-sync-nexgendata-serp-rank-tracker-lite", "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/nexgendata~serp-rank-tracker-lite/run-sync": { "post": { "operationId": "run-sync-nexgendata-serp-rank-tracker-lite", "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", "domain" ], "properties": { "keywords": { "title": "Keywords", "minItems": 1, "maxItems": 100, "type": "array", "description": "Keywords to track (max 100 per run). Each keyword consumes one billable event.", "items": { "type": "string" } }, "domain": { "title": "Target domain", "type": "string", "description": "Domain to look up in the SERP (without protocol, e.g. 'thenextgennexus.com'). Returns rank position if found in top 100 results." }, "searchEngine": { "title": "Search engine", "enum": [ "google", "bing", "duckduckgo" ], "type": "string", "description": "Which engine to query. Google is read directly by this actor through Apify's Google SERP proxy (nothing extra to run or pay outside this actor's own price). Bing and DuckDuckGo are also fetched directly. A keyword the engine does not answer is pushed with an `error` field and `billed: false`, and is not charged.", "default": "bing" }, "country": { "title": "Country (ISO code)", "type": "string", "description": "Two-letter ISO country code for localized results (e.g. 'us', 'gb', 'de', 'ca').", "default": "us" }, "language": { "title": "Language", "type": "string", "description": "Two-letter language code (e.g. 'en', 'fr', 'de', 'es').", "default": "en" }, "device": { "title": "Device", "enum": [ "desktop", "mobile" ], "type": "string", "description": "Device profile to emulate. Mobile SERPs differ significantly from desktop, including AIO trigger rates.", "default": "desktop" }, "includeCompetitors": { "title": "Include top-10 competitors", "type": "boolean", "description": "Emit the top-10 organic results per keyword for competitive analysis.", "default": true }, "detectAIOverview": { "title": "Detect AI Overview (Google only)", "type": "boolean", "description": "Record whether Google shows an AI Overview for the keyword (yes/no). The overview's text and sources are not captured. Google only.", "default": true }, "maxKeywords": { "title": "Max keywords (safety cap)", "minimum": 1, "maximum": 100, "type": "integer", "description": "Hard cap on number of keywords processed in this run. Useful for cost control when feeding large lists from another actor.", "default": 100 } } }, "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 } } } } } } } } } }