{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper & API — Bulk Keywords, Trending Now", "description": "Bulk Google Trends + full Trending Now (hundreds of trends a day with search volume, % increase, categories, 4h–7d). Interest over time with stats, by state/city/metro, rising queries, comparisons, pasted Trends URLs. Empty results are free.", "version": "0.2", "x-build-id": "UBYJ3MSrIjCLcpegf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/trendpilot_data~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-trendpilot_data-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/trendpilot_data~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-trendpilot_data-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/trendpilot_data~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-trendpilot_data-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", "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "Search terms to analyze. Each keyword gets its own report (or see 'Compare keywords').", "items": { "type": "string" } }, "startUrls": { "title": "Google Trends URLs", "type": "array", "description": "Paste links copied from Google Trends. Explore pages (trends.google.com/trends/explore?q=...) keep their own terms, location, time range, category and search type. Trending Now pages (trends.google.com/trending?geo=...) keep their location, time window, category and active-only filter. Other links are skipped with a warning.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "compareKeywords": { "title": "Compare keywords against each other", "type": "boolean", "description": "If on, keywords are compared in groups of up to 5 (Google's limit), so values are relative to each other — like typing several terms into Google Trends. If off, each keyword is scaled independently (0–100).", "default": false }, "geo": { "title": "Location", "type": "string", "description": "Country or region code, e.g. US, GB, DE, US-CA. Leave empty for Worldwide.", "default": "" }, "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": "Preset time range.", "default": "today 12-m" }, "customTimeframe": { "title": "Custom time range (overrides preset)", "type": "string", "description": "Exact date range as 'YYYY-MM-DD YYYY-MM-DD', e.g. '2025-01-01 2025-12-31'." }, "category": { "title": "Category", "type": "string", "description": "Limit to a Google Trends category. Pick one from the list or type any numeric category ID (subcategories work too, e.g. 1227 for Coffee & Tea).", "default": "" }, "property": { "title": "Search type", "enum": [ "", "images", "news", "froogle", "youtube" ], "type": "string", "description": "Which Google search property to use.", "default": "" }, "includeTimeline": { "title": "Interest over time", "type": "boolean", "description": "Include the time series plus summary stats (average, peak, latest, % change, direction).", "default": true }, "includeRegions": { "title": "Interest by region", "type": "boolean", "description": "Include the breakdown by country / state / city.", "default": true }, "includeRelatedQueries": { "title": "Related queries (top + rising)", "type": "boolean", "description": "Include top and rising related searches, with 'Breakout' flags.", "default": true }, "regionResolution": { "title": "Region resolution", "enum": [ "", "COUNTRY", "REGION", "CITY", "DMA" ], "type": "string", "description": "Granularity of the region breakdown. Auto = countries for Worldwide, states/provinces for a country. Inside a state (e.g. US-CA) Google offers metro areas but no cities — City then falls back to Metro (DMA).", "default": "" }, "includeLowVolumeRegions": { "title": "Include low-volume regions", "type": "boolean", "description": "Also return regions with too little search volume (value 0).", "default": false }, "trendingGeos": { "title": "Trending Now — locations", "type": "array", "description": "Country codes (US, GB, IN …) or US states (US-CA, US-NY) to fetch trending searches for: search volume, % increase, start/end time, categories, related \"trend breakdown\" searches, plus news for the newest ones. Works with or without keywords.", "items": { "type": "string" } }, "trendingHours": { "title": "Trending window", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "How far back to look, same as the Trending Now page.", "default": "24" }, "trendingCategories": { "title": "Trending categories", "type": "array", "description": "Only keep trends in these categories. Empty = all categories.", "items": { "type": "string", "enum": [ "Autos and Vehicles", "Beauty and Fashion", "Business and Finance", "Climate", "Entertainment", "Food and Drink", "Games", "Health", "Hobbies and Leisure", "Jobs and Education", "Law and Government", "Other", "Pets and Animals", "Politics", "Science", "Shopping", "Sports", "Technology", "Travel and Transportation" ] } }, "trendingActiveOnly": { "title": "Active trends only", "type": "boolean", "description": "Skip trends that have already ended.", "default": false }, "trendingSort": { "title": "Sort trends by", "enum": [ "relevance", "volume", "recency", "title" ], "type": "string", "description": "Relevance is Google's own order.", "default": "relevance" }, "trendingMaxItems": { "title": "Max trends per location", "minimum": 0, "type": "integer", "description": "Limit per location after filters and sorting (Google lists several hundred trends per day, thousands for 7 days). 0 = no limit. You pay per trend returned.", "default": 100 }, "trendingIncludeNews": { "title": "Add news articles", "type": "boolean", "description": "Attach news articles and a picture to the trends Google publishes in its news feed — usually the newest ~10 per location; other trends get an empty list. One extra request per location.", "default": true }, "language": { "title": "Language", "type": "string", "description": "Interface language for labels, e.g. en-US, de, fr.", "default": "en-US" }, "timezoneOffset": { "title": "Timezone offset (minutes)", "type": "integer", "description": "Timezone offset from UTC in minutes, as Google expects it (e.g. 300 for US Eastern standard time, -60 for CET). 0 = UTC.", "default": 0 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel workers, each with its own proxy session. Higher is faster but triggers Google rate limits more often.", "default": 3 }, "maxRetries": { "title": "Max retries per request", "minimum": 0, "maximum": 20, "type": "integer", "description": "On rate limits the scraper switches to a fresh IP and retries.", "default": 8 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxies are strongly recommended — Google rate-limits datacenter IPs heavily.", "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 } } } } } } } } } }