{ "openapi": "3.0.1", "info": { "title": "Google Trends Compare More Than 5 Keywords", "description": "Google Trends for hundreds of keywords on one 0-100 scale: compare more than 5 keywords in bulk, linked through keywords of similar size, with an error bound per keyword. Or each keyword separately with regions and related queries. Pay only for keywords with data.", "version": "0.1", "x-build-id": "Nu77rmKo7zPDYCjPq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/firsthand~google-trends-keyword-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-firsthand-google-trends-keyword-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/firsthand~google-trends-keyword-scraper/runs": { "post": { "operationId": "runs-sync-firsthand-google-trends-keyword-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/firsthand~google-trends-keyword-scraper/run-sync": { "post": { "operationId": "run-sync-firsthand-google-trends-keyword-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", "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "Search terms to look up, one per line (2,000 tested in one run). Each term is at most 100 characters. Also read from searchTerms, keyword (comma separated) and Google Trends explore links in startUrls.", "items": { "type": "string" } }, "scaleMode": { "title": "Scale", "enum": [ "oneScale", "separate", "groupsOf5" ], "type": "string", "description": "One scale for the whole list: every keyword on the same 0-100 scale, 100 is the peak of the strongest keyword, so values can be compared across thousands of terms. Keywords are linked step by step through keywords of similar size from your list, each row carries errorPct. Interest over time only. Separate: every keyword on its own 0-100 scale, with regions and related queries. Groups of 5: like the Compare button, five keywords at a time on one scale. Empty means Separate." }, "geos": { "title": "Countries or regions", "type": "array", "description": "Two-letter country codes (US, GB, DE) or state codes (US-CA). Every keyword is looked up in every region. Add WORLDWIDE for the whole world. Empty means US. Also read from geo.", "items": { "type": "string" } }, "period": { "title": "Period", "enum": [ "now 1-H", "now 4-H", "now 1-d", "now 7-d", "today 1-m", "today 3-m", "today 12-m", "today 5-y", "all", "custom" ], "type": "string", "description": "Period of the interest curve. Empty means past 12 months. Also read from timeframe and timeRange." }, "customTimeRange": { "title": "Custom range", "type": "string", "description": "Only with Period set to Custom range. Format: 2024-01-01 2024-06-30" }, "searchType": { "title": "Search type", "enum": [ "web", "youtube", "news", "images", "shopping" ], "type": "string", "description": "Which Google search the interest comes from. Empty means web search. Also read from property and searchProperty." }, "trendsCategory": { "title": "Category number", "minimum": 0, "type": "integer", "description": "Google Trends category number, 0 or empty means all categories (for example 71 is Food and Drink). Also read from category." }, "language": { "title": "Language", "type": "string", "description": "Interface language, for example en-US or de. Empty means en-US. It changes the language of related queries and region names, not the numbers." }, "includeRegions": { "title": "Include interest by region", "type": "boolean", "description": "Separate and Groups of 5 only. Interest by sub-region for each keyword. On unless you turn it off." }, "includeRelatedQueries": { "title": "Include related queries", "type": "boolean", "description": "Separate and Groups of 5 only. Top and rising related queries for each keyword. On unless you turn it off." }, "maxItems": { "title": "Maximum rows", "minimum": 0, "type": "integer", "description": "Stop after this many keyword and region rows. 0 or empty means no limit besides your maximum cost per run." }, "proxyConfiguration": { "title": "Your own proxy URLs (optional)", "type": "object", "description": "Leave empty: the Actor uses rotating residential proxies, included in the price. Only your own proxy URLs are used from here; any Apify Proxy setting is ignored (Google blocks Apify datacenter proxies within one run)." } } }, "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 } } } } } } } } } }