{ "openapi": "3.0.1", "info": { "title": "Google Keyword Research: Autocomplete & People Also Ask", "description": "Google keyword research tool: get keyword ideas from Google Autocomplete (with question and a-z expansion), the questions in People also ask and related searches, for any keyword, country and language. Long-tail keywords, questions and search intent for SEO and content. Pay per keyword idea.", "version": "1.0", "x-build-id": "AF0eclloMJzZvg1yF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fguiraud~google-keyword-research/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fguiraud-google-keyword-research", "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/fguiraud~google-keyword-research/runs": { "post": { "operationId": "runs-sync-fguiraud-google-keyword-research", "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/fguiraud~google-keyword-research/run-sync": { "post": { "operationId": "run-sync-fguiraud-google-keyword-research", "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": { "keywords": { "title": "Keywords", "type": "array", "description": "Seed keywords or topics, one per line (up to 200 per run), e.g. 'how to learn python' or 'best crm for small business'. Each one is expanded into keyword ideas.", "items": { "type": "string" } }, "sources": { "title": "Sources", "type": "array", "description": "'autocomplete': Google's search suggestions (with the expansions below). 'peopleAlsoAsk': the questions Google shows in 'People also ask'. 'relatedSearches': 'People also search for' at the bottom of the results. All three by default.", "items": { "type": "string", "enum": [ "autocomplete", "peopleAlsoAsk", "relatedSearches" ], "enumTitles": [ "Google Autocomplete", "People also ask", "Related searches (People also search for)" ] }, "default": [ "autocomplete", "peopleAlsoAsk", "relatedSearches" ] }, "expand": { "title": "Autocomplete expansion", "enum": [ "none", "questions", "alphabet", "questions-and-alphabet" ], "type": "string", "description": "How many autocomplete requests per keyword: the keyword alone (~10 ideas), with question words and modifiers (~100 ideas), with every letter a-z (~150), or both (~250). The price is per idea delivered, so more expansion means more ideas and a higher cost.", "default": "questions" }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code for Google (gl), e.g. us, gb, ca, au, in, es, mx, br, de.", "default": "us" }, "language": { "title": "Language", "type": "string", "description": "Language code for Google (hl), e.g. en, es, pt-BR, de, fr.", "default": "en" }, "onlyQuestions": { "title": "Only questions", "type": "boolean", "description": "Keep only ideas that are questions (how, what, why... or ending with '?'). Good for FAQ pages and content briefs.", "default": false }, "maxIdeasPerKeyword": { "title": "Max ideas per keyword", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Caps the ideas (and the cost) per keyword.", "default": 300 }, "dedupeAcrossSeeds": { "title": "Remove duplicates across keywords", "type": "boolean", "description": "An idea found for one keyword is not repeated (or charged) for the next ones. Off: each keyword gets its full list.", "default": false }, "failOnError": { "title": "Fail the run on errors", "type": "boolean", "description": "Mark the run as failed when nothing is found or the results look broken. Useful for scheduled monitoring (Apify emails you on failed runs).", "default": false } } }, "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 } } } } } } } } } }