{ "openapi": "3.0.1", "info": { "title": "Google Rank Tracker — Keyword Positions by Domain", "description": "Check where your website ranks on Google for any keyword, in any country, on desktop or mobile. Returns your position, the ranking URL and the top 10 competitors — plus real monthly search volume and cost-per-click so you can sort keywords by what a position is actually worth.", "version": "0.0", "x-build-id": "YMV3oU9qazOl1pR44" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/aitorsm~google-rank-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-aitorsm-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/aitorsm~google-rank-tracker/runs": { "post": { "operationId": "runs-sync-aitorsm-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/aitorsm~google-rank-tracker/run-sync": { "post": { "operationId": "run-sync-aitorsm-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", "properties": { "demoMode": { "title": "See a free sample first", "type": "boolean", "description": "Returns a ready-made example straight away so you can see exactly what you get. Nothing is checked and nothing is charged. Switch this off to track your own site.", "default": false }, "domain": { "title": "Your website", "type": "string", "description": "The site you want to find in the results. Enter it plainly, without https:// — subdomains are matched too. Leave it empty and you simply get the top results for each keyword, which is handy for sizing up a market you are not in yet." }, "keywords": { "title": "Keywords", "type": "array", "description": "The searches you want to hold a position for. One per line. Phrase them the way a customer would, not the way you describe yourself internally.", "items": { "type": "string" } }, "report": { "title": "Include the summary report", "type": "boolean", "description": "Adds one summary at the end: how many keywords improved or slipped, net places gained, what the week's movement is worth, which competitors are showing up across your whole keyword set, and where your biggest opportunities are. This is the part worth forwarding.", "default": true }, "trackChanges": { "title": "Compare against my last check", "type": "boolean", "description": "Reports what moved since you last ran this: places gained or lost, keywords that entered or fell out of the top 10, competitors that just appeared, and whether the page Google ranks has changed. Your history is kept on your own account and never leaves it. Schedule this weekly and you get a trend.", "default": true }, "weightByDemand": { "title": "Show me what each position is worth", "type": "boolean", "description": "Adds how many people search each keyword every month and what advertisers pay per click. Position 4 on a keyword nobody searches matters less than position 11 on one people pay $20 a click for — this lets you sort by value instead of by rank.", "default": false }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code — rankings differ by market (us, gb, es, de…).", "default": "us" }, "language": { "title": "Language", "type": "string", "description": "Two-letter language code (en, es, de…).", "default": "en" }, "device": { "title": "Desktop or mobile", "enum": [ "desktop", "mobile" ], "type": "string", "description": "Positions genuinely differ between the two, so check whichever your customers actually use.", "default": "desktop" } } }, "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 } } } } } } } } } }