{ "openapi": "3.0.1", "info": { "title": "Google Autocomplete Scraper", "description": "Keyword ideas from Google's search suggestions in 50 countries, with YouTube, Google Shopping and Bing as extra sources. Each keyword is expanded with letters, digits, questions and prepositions, and each phrase shows how often it came up.", "version": "0.1", "x-build-id": "sMkQhnc3ktPStBHyw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/deriverge~google-autocomplete-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-deriverge-google-autocomplete-scraper", "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/deriverge~google-autocomplete-scraper/runs": { "post": { "operationId": "runs-sync-deriverge-google-autocomplete-scraper", "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/deriverge~google-autocomplete-scraper/run-sync": { "post": { "operationId": "run-sync-deriverge-google-autocomplete-scraper", "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" ], "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "Seed keywords, one per line, for example \"running shoes\", \"crm software\" or a brand name. Each one is expanded and its suggestions are merged.", "items": { "type": "string" } }, "sources": { "title": "Sources", "uniqueItems": true, "type": "array", "description": "Which autocomplete to read. Pick several to compare what people type on Google, YouTube, Google Shopping and Bing.", "items": { "type": "string", "enumSuggestedValues": [ "google", "youtube", "googleShopping", "bing" ], "enumTitles": [ "Google Search", "YouTube", "Google Shopping", "Bing" ] }, "default": [ "google" ] }, "country": { "title": "Country", "enum": [ "US", "GB", "CA", "AU", "IN", "IE", "NZ", "SG", "AE", "ZA", "PH", "DE", "AT", "CH", "FR", "BE", "IT", "ES", "PT", "NL", "SE", "DK", "NO", "FI", "PL", "CZ", "SK", "HU", "RO", "GR", "TR", "UA", "MX", "AR", "CO", "CL", "BR", "JP", "KR", "TW", "HK", "ID", "MY", "TH", "VN", "SA", "EG", "IL", "NG", "PK" ], "type": "string", "description": "Country of the searchers. It also picks the Bing market (for example Germany uses de-DE).", "default": "US" }, "language": { "title": "Language", "type": "string", "description": "Language code such as en, de, es or pt-BR. Empty means the main language of the country." }, "expansions": { "title": "Expand keywords with", "uniqueItems": true, "type": "array", "description": "Besides the keyword itself, also ask for the keyword followed by each letter and digit, preceded by question words, or followed by prepositions. Question and preposition words are localized for English, German, French, Spanish, Italian, Portuguese, Dutch, Polish and Czech. Leave empty for the keyword alone.", "items": { "type": "string", "enum": [ "alphabet", "questions", "prepositions" ], "enumTitles": [ "Letters and digits (keyword a, keyword b ... keyword 9)", "Questions (how, what, why ... keyword)", "Prepositions and comparisons (keyword for, with, vs ...)" ] }, "default": [ "alphabet" ] }, "maxSuggestionsPerKeyword": { "title": "Maximum suggestions per keyword and source", "minimum": 1, "type": "integer", "description": "Stop expanding a keyword once this many unique suggestions are collected for one source.", "default": 1000 }, "newOnly": { "title": "Return only suggestions new since the last run", "type": "boolean", "description": "Keeps a snapshot per watch name (or per saved task) and returns only suggestions that were not there before. Schedule it to spot new trends and new searches around your brand.", "default": false }, "watchName": { "title": "Watch name", "type": "string", "description": "Name of the snapshot, for example \"brand-monitor\". Also fills the CHANGES record with the changes in the top 10 suggestions for each keyword. Runs from a saved task get one automatically." }, "maxItems": { "title": "Maximum rows", "minimum": 1, "type": "integer", "description": "Hard cap on returned suggestions in the run.", "default": 100000 } } }, "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 } } } } } } } } } }