{ "openapi": "3.0.1", "info": { "title": "Keyword Research Tool — Ideas, Trend Interest & Seasonality", "description": "Keyword ideas from Google autocomplete (optionally YouTube and Amazon), ranked by Google Trends interest on one shared scale, with trend direction, peak month and rising terms. Set a country and language. No login, no SEO-tool subscription.", "version": "0.1", "x-build-id": "oQ4C0f1HeIkk5hrZm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/northbell~keyword-research-tool/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-northbell-keyword-research-tool", "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/northbell~keyword-research-tool/runs": { "post": { "operationId": "runs-sync-northbell-keyword-research-tool", "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/northbell~keyword-research-tool/run-sync": { "post": { "operationId": "run-sync-northbell-keyword-research-tool", "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": [ "seeds" ], "properties": { "seeds": { "title": "Seed keywords", "type": "array", "description": "One topic per line, as you would type it into Google, e.g. running shoes. Each seed gets its own ranked list of ideas. Put all your seeds in one run: the run-start fee is charged once. Up to 20 per run.", "items": { "type": "string" } }, "sources": { "title": "Where to find ideas", "type": "array", "description": "The search boxes whose suggestions become ideas. An idea that more than one of them suggests is listed first before Google Trends ranks the ideas. Amazon follows the country below and covers US, GB, DE, FR, IT, ES, CA, JP, AU, MX, BR, NL, SE, PL, TR, AE, SA and SG.", "items": { "type": "string", "enum": [ "google", "youtube", "amazon" ], "enumTitles": [ "Google autocomplete", "YouTube autocomplete", "Amazon autocomplete" ] }, "default": [ "google" ] }, "maxIdeas": { "title": "Ideas per seed", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many ideas to keep and rank for each seed (1 to 100). Only ideas that get a Google Trends score are charged. Every 4 more ideas add one Google Trends request, about 4 seconds.", "default": 25 }, "geo": { "title": "Country", "type": "string", "description": "Two-letter country code, e.g. US, GB, DE, JP. Google Trends measures the interest in this country. Autocomplete uses it as the market, but Google also mixes in a few suggestions based on where the Actor runs, so treat the ideas as a hint for that country.", "default": "US" }, "language": { "title": "Language", "type": "string", "description": "Language of the suggestions, e.g. en, de, ja, pt-BR. Write your seeds in this language.", "default": "en" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Google Trends answers HTTP 429 (rate limit) to most requests that come straight from cloud servers. Apify Proxy (datacenter, part of your Apify plan) is on by default and used for Google Trends only: in our test on 8 October 2026 every request through it was answered, and none without it. Autocomplete is asked directly.", "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 } } } } } } } } } }