{
"openapi": "3.0.1",
"info": {
"title": "Google Rank Tracker: SERP Keyword Positions",
"description": "Track where your website ranks on Google for up to 1,000 keywords: position, ranking URL and change since the last run, plus up to 10 competitors, AI Overview citations and featured snippets. Any country, city, language, desktop or mobile, top 10 to top 100. Pay per keyword.",
"version": "1.0",
"x-build-id": "Bul8pqUiaJamxcQsk"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/vncntlabs~google-rank-tracker/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-vncntlabs-google-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/vncntlabs~google-rank-tracker/runs": {
"post": {
"operationId": "runs-sync-vncntlabs-google-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/vncntlabs~google-rank-tracker/run-sync": {
"post": {
"operationId": "run-sync-vncntlabs-google-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": [
"domain",
"keywords"
],
"properties": {
"domain": {
"title": "Your website (domain)",
"type": "string",
"description": "The domain to track, e.g. example.com. Subdomains (www, blog, shop...) count as the same site."
},
"keywords": {
"title": "Keywords",
"type": "array",
"description": "One keyword per line, up to 1,000. Each keyword is one Google search.",
"items": {
"type": "string"
}
},
"competitors": {
"title": "Competitors (optional)",
"type": "array",
"description": "Up to 10 competitor domains checked in the same searches at no extra cost, e.g. nike.com.",
"items": {
"type": "string"
}
},
"country": {
"title": "Country",
"enum": [
"Argentina",
"Australia",
"Austria",
"Bangladesh",
"Belgium",
"Brazil",
"Bulgaria",
"Canada",
"Chile",
"Colombia",
"Costa Rica",
"Croatia",
"Cyprus",
"Czechia",
"Denmark",
"Dominican Republic",
"Ecuador",
"Egypt",
"Estonia",
"Finland",
"France",
"Germany",
"Greece",
"Hong Kong",
"Hungary",
"Iceland",
"India",
"Indonesia",
"Ireland",
"Israel",
"Italy",
"Japan",
"Kenya",
"Kuwait",
"Latvia",
"Lithuania",
"Luxembourg",
"Malaysia",
"Malta",
"Mexico",
"Morocco",
"Netherlands",
"New Zealand",
"Nigeria",
"Norway",
"Pakistan",
"Peru",
"Philippines",
"Poland",
"Portugal",
"Puerto Rico",
"Qatar",
"Romania",
"Saudi Arabia",
"Serbia",
"Singapore",
"Slovakia",
"Slovenia",
"South Africa",
"South Korea",
"Spain",
"Sweden",
"Switzerland",
"Taiwan",
"Thailand",
"Turkiye",
"Ukraine",
"United Arab Emirates",
"United Kingdom",
"United States",
"Uruguay",
"Vietnam"
],
"type": "string",
"description": "Google country edition.",
"default": "United States"
},
"location": {
"title": "City or region (optional)",
"type": "string",
"description": "For local rankings, e.g. Austin,Texas,United States or London,England,United Kingdom (city,region,country). Leave empty for country-wide results."
},
"language": {
"title": "Language",
"type": "string",
"description": "Optional language code (en, de, fr, es, pt-BR...). Defaults to the country's main language."
},
"device": {
"title": "Device",
"enum": [
"desktop",
"mobile"
],
"type": "string",
"description": "Desktop and mobile rankings often differ.",
"default": "desktop"
},
"depth": {
"title": "Positions to check (top N)",
"minimum": 10,
"maximum": 100,
"type": "integer",
"description": "10 to 100, in steps of 10 (e.g. 10, 20, 30, 50, 100). How deep to look; default top 30 (usually 1-4 minutes). The top 100 can take 15+ minutes unless fast mode is on. The top 20 is included in the keyword price; deeper checks add a small charge per 10 positions.",
"default": 30
},
"fastMode": {
"title": "Fast mode",
"type": "boolean",
"description": "Results in about 30 seconds instead of 1-5 minutes (15+ for the top 100), at a small extra charge per 10 positions. Scheduled tracking doesn't need it.",
"default": false
},
"checkAiOverview": {
"title": "Check Google AI Overviews",
"type": "boolean",
"description": "Detect AI Overviews and whether your site (and each competitor) is cited in them. Charged only for keywords that show an AI Overview.",
"default": true
},
"trackHistory": {
"title": "Track changes between runs",
"type": "boolean",
"description": "Remembers positions from the previous run of the same domain, location, language and device, and adds previousPosition, change and status (up, down, new, lost). Stored in your Apify account (key-value store 'google-rank-tracker-history').",
"default": true
},
"outputChangesOnly": {
"title": "Output only changed keywords",
"type": "boolean",
"description": "For scheduled runs: only keywords whose position (yours or a competitor's) changed since the last run are written to the dataset. Every keyword is still checked and charged; the run summary covers all of them.",
"default": false
},
"serpResultsPerKeyword": {
"title": "Also save the top results",
"minimum": 0,
"maximum": 100,
"type": "integer",
"description": "Optional: also write the top N organic results (URL, title, snippet) for each keyword as extra rows, free of charge.",
"default": 0
},
"monitorId": {
"title": "Tracker name",
"type": "string",
"description": "Optional. Name this tracker to keep its history separate, e.g. client-acme-us-mobile."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}