{ "openapi": "3.0.1", "info": { "title": "Keyword Trends Finder – Autocomplete Ideas + Google Trends", "description": "Find hundreds of keyword ideas from Google Autocomplete (a–z, questions, modifiers) plus rising and breakout queries from Google Trends, each with its trend direction (rising, stable, falling) and change in %. Flat CSV-ready rows for SEO and content planning. Pay per keyword.", "version": "0.1", "x-build-id": "ow4AV9HQpzDYDtZkp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stevenkramp~keyword-trends-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stevenkramp-keyword-trends-finder", "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/stevenkramp~keyword-trends-finder/runs": { "post": { "operationId": "runs-sync-stevenkramp-keyword-trends-finder", "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/stevenkramp~keyword-trends-finder/run-sync": { "post": { "operationId": "run-sync-stevenkramp-keyword-trends-finder", "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": [ "seedKeywords" ], "properties": { "seedKeywords": { "title": "Seed keywords", "type": "array", "description": "Topics to expand, e.g. \"ai agents\", \"air fryer recipes\". Each seed gives up to the maximum number of keyword ideas below.", "items": { "type": "string" } }, "country": { "title": "Country (gl)", "type": "string", "description": "Two-letter country code for suggestions and trends, e.g. us, gb, de, in.", "default": "us" }, "language": { "title": "Language (hl)", "type": "string", "description": "Two-letter language code, e.g. en, de, fr. German also switches the question words (wie, was, warum …).", "default": "en" }, "maxKeywordsPerSeed": { "title": "Max keyword ideas per seed", "minimum": 1, "maximum": 500, "type": "integer", "description": "Up to 500. You only pay for keyword ideas returned.", "default": 100 }, "includeQuestions": { "title": "Question and modifier ideas", "type": "boolean", "description": "how / what / why / best … + seed, and seed + for / vs / without / free / alternative …", "default": true }, "includeAlphabet": { "title": "Alphabet expansion (a–z)", "type": "boolean", "description": "seed + a, seed + b … seed + z – finds long-tail keywords.", "default": true }, "customModifiers": { "title": "Your own modifiers (optional)", "type": "array", "description": "Extra words added after the seed, e.g. \"2026\", \"price\", \"course\".", "items": { "type": "string" } }, "addTrends": { "title": "Add Google Trends direction", "type": "boolean", "description": "Checks the trend (rising, stable, falling, change in %) for the first keyword ideas, and adds rising and top related queries of each seed from Google Trends.", "default": true }, "maxTrendsPerSeed": { "title": "Trend checks per seed", "minimum": 0, "maximum": 200, "type": "integer", "description": "How many keyword ideas per seed get a trend check (the seed itself included). Ideas beyond this number are returned with trendDirection \"not-checked\".", "default": 30 }, "trendsTimeRange": { "title": "Trend period", "enum": [ "today 1-m", "today 3-m", "today 12-m", "today 5-y" ], "type": "string", "description": "Period for the trend direction.", "default": "today 12-m" }, "trendsWorldwide": { "title": "Trends worldwide", "type": "boolean", "description": "Off: trends for the selected country. On: worldwide trends.", "default": false }, "filterRelevantTrends": { "title": "Filter unrelated Trends queries", "type": "boolean", "description": "Keep related queries containing the seed's meaningful words, queries also returned by this seed's Autocomplete, or your optional relevance keywords. Applies to rising and top queries before limits and billing. Turn off for unfiltered discovery; lexical filtering can omit synonyms and new names.", "default": true }, "relevanceKeywords": { "title": "Additional relevance keywords (optional)", "type": "array", "description": "Extra topic names, synonyms or products to keep when filtering, e.g. openclaw. Each entry is an alternative anchor; all its meaningful words must occur in the candidate. Shared across seeds. Ignored when the filter is off.", "default": [], "items": { "type": "string" } }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many requests run at the same time.", "default": 4 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential Apify Proxy is used by default for the best success rate. Usually no change needed.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }