{ "openapi": "3.0.1", "info": { "title": "Keyword Ideas: Google, YouTube & Bing Autocomplete", "description": "Hundreds of long-tail keyword ideas per seed from Google, YouTube, Bing and DuckDuckGo autocomplete. Alphabet and question expansion, 35+ countries and any language, optional monthly search volume, CPC and competition. Export to CSV, Excel or JSON.", "version": "0.1", "x-build-id": "OxbVfNwLVaEHeVyeY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/watchmere~keyword-ideas-autocomplete/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-watchmere-keyword-ideas-autocomplete", "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/watchmere~keyword-ideas-autocomplete/runs": { "post": { "operationId": "runs-sync-watchmere-keyword-ideas-autocomplete", "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/watchmere~keyword-ideas-autocomplete/run-sync": { "post": { "operationId": "run-sync-watchmere-keyword-ideas-autocomplete", "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": "Seed keywords", "type": "array", "description": "The topics to find ideas for, one per line. Each one is typed into the search box the way a person would, and every suggestion the search engine offers comes back as a result.", "items": { "type": "string" } }, "sources": { "title": "Where to get suggestions", "type": "array", "description": "Google gives the most ideas. YouTube shows what people want to watch. Bing and DuckDuckGo add different wording.", "items": { "type": "string", "enum": [ "google", "youtube", "bing", "duckduckgo" ], "enumTitles": [ "Google", "YouTube", "Bing", "DuckDuckGo" ] }, "default": [ "google" ] }, "expand": { "title": "How deep to dig", "enum": [ "none", "alphabet", "questions", "everything" ], "type": "string", "description": "Alphabet adds a-z and 0-9 after each keyword (\"coffee maker a\", \"coffee maker b\"...), which finds hundreds of long-tail ideas. Questions adds how/what/why/best before it and for/with/vs after it. Everything does both.", "default": "alphabet" }, "country": { "title": "Country", "enum": [ "us", "ar", "au", "at", "be", "br", "ca", "cl", "co", "dk", "fi", "fr", "de", "in", "id", "ie", "it", "jp", "my", "mx", "nl", "nz", "no", "ph", "pl", "pt", "sg", "za", "kr", "es", "se", "ch", "tr", "ae", "gb" ], "type": "string", "description": "Suggestions (and search volume) for searchers in this country.", "default": "us" }, "language": { "title": "Language", "pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z]{2,4})?$", "type": "string", "description": "Two-letter language code, for example en, es, de, fr or pt-br.", "default": "en" }, "maxSuggestionsPerKeyword": { "title": "Max ideas per keyword and source", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stops collecting for a keyword once this many unique ideas are found from a source. Keeps cost predictable.", "default": 300 }, "includeSearchVolume": { "title": "Add search volume, CPC and competition", "type": "boolean", "description": "Adds monthly Google search volume, the last 12 months of searches, cost per click and ad competition for each idea (Google Ads data). Ideas that come back with search volume are charged at the higher rate shown on the Pricing tab.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy keeps the search engines from slowing down large runs. The default works for most people.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }