{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper - Trending, Keywords & Compare", "description": "Reliable Google Trends data: daily trending searches, interest over time, interest by region and related queries. Filter by category and search type (Web, News, Images, Shopping, YouTube). Residential proxy rotation and 429 backoff so runs do not fail.", "version": "1.0", "x-build-id": "qwn75ZehWYFWQXM1R" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alex_expert~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alex_expert-google-trends-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/alex_expert~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-alex_expert-google-trends-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/alex_expert~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-alex_expert-google-trends-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": [ "mode" ], "properties": { "mode": { "title": "What to scrape", "enum": [ "trendingNow", "keywords" ], "type": "string", "description": "Trending now = today's hot searches for a country (no keywords needed). Keyword research = interest over time, interest by region and related queries for your own keywords.", "default": "trendingNow" }, "keywords": { "title": "Keywords", "type": "array", "description": "Search terms to analyse. Used only when mode = Keyword research. Plain words, not URLs. Example: coffee machine", "default": [ "bitcoin" ], "items": { "type": "string" } }, "startUrls": { "title": "Google Trends URLs", "type": "array", "description": "Paste addresses copied straight from trends.google.com/trends/explore. Keywords, country, time range and category are read from the URL. Works alongside the Keywords field.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "compareKeywords": { "title": "Compare keywords with each other", "type": "boolean", "description": "Put all keywords on one normalised chart, the way Google Trends compares terms. Values become relative to each other instead of independent. Maximum 5 terms.", "default": false }, "geo": { "title": "Country", "type": "string", "description": "Two-letter ISO code: US, GB, DE, UA, PL. In Trending now mode you can pass several separated by commas: US,DE,GB. Leave empty in Keyword research mode for worldwide data.", "default": "US" }, "timeframe": { "title": "Time range", "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" ], "type": "string", "description": "Google Trends time range. Keyword research mode only.", "default": "today 12-m" }, "customTimeRange": { "title": "Custom time range", "type": "string", "description": "Overrides Time range. Two ISO dates separated by a space, for example: 2023-01-01 2023-12-31", "default": "" }, "category": { "title": "Category", "enum": [ "0", "3", "5", "7", "8", "11", "12", "13", "16", "18", "20", "22", "44", "45", "47", "65", "66", "67", "71", "174", "299", "533" ], "type": "string", "description": "Narrow results to one Google Trends category. Keyword research mode only.", "default": "0" }, "searchProperty": { "title": "Search type", "enum": [ "", "images", "news", "froogle", "youtube" ], "type": "string", "description": "Which Google surface to measure. Keyword research mode only.", "default": "" }, "includeTimeseries": { "title": "Include interest over time", "type": "boolean", "description": "Popularity score 0-100 for each point in the time range.", "default": true }, "includeRegions": { "title": "Include interest by region", "type": "boolean", "description": "Which regions search for this keyword the most.", "default": true }, "includeRelated": { "title": "Include related queries", "type": "boolean", "description": "Top and rising related search queries.", "default": true }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Hard cap on result rows, so you always know the maximum a run can cost. 0 means no limit.", "default": 0 }, "language": { "title": "Language", "type": "string", "description": "Interface language for the returned labels, for example en-US or de.", "default": "en-US" }, "maxRetries": { "title": "Max retries per request", "minimum": 1, "maximum": 20, "type": "integer", "description": "Google rate limits aggressively. Each retry rotates to a fresh proxy IP. Permanent errors such as a wrong country code are never retried.", "default": 8 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential proxies are recommended for large runs. Google returns HTTP 429 to datacenter IPs under load.", "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 } } }, "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 } } } } } } } } } }