{ "openapi": "3.0.1", "info": { "title": "Trending Keywords Scraper — Google Trends Rising Queries", "description": "Google Trends breakout keywords: breakout and rising queries with the real growth % behind Google’s Breakout label, by seed keyword, country and category. On request: the 12-month curve (up to 5 per seed) and top queries with current interest. From $1.50 per 1,000 breakout keywords, no start fee.", "version": "1.0", "x-build-id": "co1QgUhRsaRsGfFso" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/steadyfetch~breakout-keywords-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-steadyfetch-breakout-keywords-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/steadyfetch~breakout-keywords-scraper/runs": { "post": { "operationId": "runs-sync-steadyfetch-breakout-keywords-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/steadyfetch~breakout-keywords-scraper/run-sync": { "post": { "operationId": "run-sync-steadyfetch-breakout-keywords-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": [ "searchTerms" ], "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Seed keywords, e.g. [\"ai agents\"] — one per line, each returning its own rising queries; a seed needs real search volume, so head terms, brands and categories work while whole sentences usually return nothing. A seed with no rising data, and a blocked or failed fetch, are never charged — each comes back as a row saying so. A full 0-100 timeline is at steadyfetch/google-trends-scraper; today's trending searches, at steadyfetch/google-trends-now-scraper. Leave this empty and click Start to run a one-seed sample (\"ai agents\", up to 5 rising queries), charged like any run — any other setting you touched is applied to it.", "default": [], "items": { "type": "string" } }, "geo": { "title": "Location", "type": "string", "description": "Two-letter country code (US, GB, DE), a sub-region (US-CA), or empty for worldwide. Rising queries differ a lot by country. Set only this and no keywords, and Start runs the sample seed under it.", "default": "" }, "timeRange": { "title": "Time range", "type": "string", "description": "The window Google compares against to decide what is rising. Set only this and no keywords, and Start runs the sample seed under it.", "default": "today 12-m" }, "category": { "title": "Category", "type": "integer", "description": "Google Trends category id to narrow the results: 0 = all categories, 3 = News, 5 = Computers & Electronics, 7 = Finance, 12 = Business & Industrial, 45 = Health, 71 = Food & Drink, 1227 = Software. Each category returns a genuinely different set. Set only this and no keywords, and Start runs the sample seed under it.", "default": 0 }, "breakoutOnly": { "title": "Breakout rows only", "type": "boolean", "description": "Keep only the queries Google itself labels \"Breakout\" (growth above roughly +5,000%). The top-queries list is skipped in this mode, since a top query is never a Breakout. Set only this and no keywords, and Start runs the sample seed under it.", "default": false }, "minGrowthPercent": { "title": "Minimum growth %", "type": "integer", "description": "Drop rising queries below this growth percentage. 0 keeps everything. Applies to rising rows only — the top-queries list has interest scores, not growth. Set only this and no keywords, and Start runs the sample seed under it.", "default": 0 }, "includeTop": { "title": "Also return top queries", "type": "boolean", "description": "Add Google's top (most-searched) related queries alongside the rising ones. These rows carry an interest score of 0-100 instead of a growth percentage, and they are charged like any other delivered row. Set only this and no keywords, and Start runs the sample seed under it.", "default": false }, "maxResultsPerKeyword": { "title": "Max results per keyword", "minimum": 1, "type": "integer", "description": "Cap the rows kept per seed and per list. Google returns at most 25 rising and 25 top queries per keyword, so 25 is the ceiling. Ask for more and the run continues at 25, with one uncharged row saying so. Set only this and no keywords, and Start runs the sample seed under it — a limit above the sample's own 5 is a ceiling, not a request.", "default": 25 }, "includeTimeline": { "title": "Attach the 12-month curve", "type": "boolean", "description": "Attach the interest-over-time curve behind each rising query. Off by default: every curve is an extra pair of requests, so a full seed takes minutes instead of seconds. Rows are never charged more for it. Set only this and no keywords, and Start runs the sample seed under it.", "default": false }, "timelineLimit": { "title": "Curves per keyword", "minimum": 0, "type": "integer", "description": "How many of the top rising queries per seed get a curve when the option above is on. At most 25 — Google returns no more rising queries than that per seed — and asking for more continues the run at 25 with one uncharged row saying so. Set only this and no keywords, and Start runs the sample seed under it.", "default": 5 } } }, "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 } } }, "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 } } } } } } } } } }