{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper – Interest, Regions, Related & Trending", "description": "Google Trends API without browser or login: interest over time, by region & city, related queries (rising/breakout), compare up to 5 terms, Trending now with search volume & news. Fast, 100% HTTP, no start fee.", "version": "0.1", "x-build-id": "1C3ykuSVFeZiBjUCX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/smoldesk~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-smoldesk-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/smoldesk~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-smoldesk-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/smoldesk~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-smoldesk-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to look up on Google Trends, e.g. 'chatgpt' or 'nasi lemak'. Each term × each country becomes one result with interest over time, interest by region/city and related queries. Turn on 'Compare terms' to put up to 5 terms on one chart instead.", "default": [ "chatgpt" ], "items": { "type": "string" } }, "compareTerms": { "title": "Compare terms", "type": "boolean", "description": "Compare the search terms against each other (groups of up to 5, like the Google Trends 'Compare' button). Values are then relative to the highest point of all terms in the group. One result per group per country.", "default": false }, "geos": { "title": "Countries / regions", "type": "array", "description": "Two-letter country codes (US, GB, MY, DE…) or sub-regions (US-CA, GB-ENG, AU-NSW). Leave empty or type 'worldwide' for worldwide data. Every term is looked up in every location.", "default": [ "US" ], "items": { "type": "string" } }, "timeRange": { "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": "Period to look at. Shorter ranges give finer data points (minute / hour), longer ones daily, weekly or monthly points.", "default": "today 12-m" }, "customTimeRange": { "title": "Custom time range", "type": "string", "description": "Optional exact dates, overrides Time range. Format 'YYYY-MM-DD YYYY-MM-DD', e.g. '2024-01-01 2024-12-31'. Ranges over ~9 months give weekly points, over ~5 years monthly." }, "category": { "title": "Category", "enum": [ "", "3", "47", "44", "22", "12", "5", "7", "71", "8", "45", "65", "11", "13", "958", "19", "16", "299", "14", "66", "29", "533", "174", "18", "20", "67" ], "type": "string", "description": "Limit to searches in one Google Trends category (helps with ambiguous words like 'jaguar' or 'apple').", "default": "" }, "property": { "title": "Search type", "enum": [ "", "images", "news", "froogle", "youtube" ], "type": "string", "description": "Which Google search to measure: web search, image search, news search, Google Shopping or YouTube search.", "default": "" }, "startUrls": { "title": "Google Trends URLs", "type": "array", "description": "Optional: paste Google Trends explore URLs (trends.google.com/trends/explore?...). Their own terms, country, dates, category and search type are used. Several comma-separated terms in one URL become a comparison.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "includeRegions": { "title": "Interest by region", "type": "boolean", "description": "Add interest by sub-region (states/provinces), or by country when the location is worldwide.", "default": true }, "includeCities": { "title": "Interest by city / metro", "type": "boolean", "description": "Add interest by city with coordinates (Google only shows cities with enough searches, so small or niche terms may have few or none). For US locations also adds interest by metro area (DMA, e.g. 'New York NY'). Not available for comparisons.", "default": false }, "includeRelatedQueries": { "title": "Related queries", "type": "boolean", "description": "Add the top and rising related searches (with 'Breakout' / +% growth).", "default": true }, "includeRelatedTopics": { "title": "Related topics", "type": "boolean", "description": "Add top and rising related topics when Google provides them. Since September 2026 Google returns this list empty for most automated requests, so expect it to be empty; related queries are unaffected.", "default": false }, "trendingGeos": { "title": "Trending now: countries", "type": "array", "description": "Country codes for Google's 'Trending now' list (e.g. US, GB, MY, IN). Each trending search becomes one result with search volume, % increase, start time, related searches and news articles. Leave empty to skip.", "items": { "type": "string" } }, "trendingHours": { "title": "Trending window", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "How far back Trending now looks.", "default": "24" }, "trendingCategory": { "title": "Trending category", "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" ], "type": "string", "description": "Only keep trending searches in this category.", "default": "" }, "trendingActiveOnly": { "title": "Active trends only", "type": "boolean", "description": "Skip trends that have already ended.", "default": false }, "maxTrendingPerGeo": { "title": "Max trending searches per country", "minimum": 0, "type": "integer", "description": "Keep only the biggest N trending searches (by search volume) per country. 0 = all (up to ~500 for the US in 24 h).", "default": 50 }, "includeTrendingNews": { "title": "Include news articles", "type": "boolean", "description": "Add the news articles Google links to each trending search (title, URL, source, time, image).", "default": true }, "newsPerTrend": { "title": "News articles per trend", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many news articles to add per trending search (1–10).", "default": 3 }, "maxItems": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Stop after this many results in total (0 = no limit). You are never charged for more than this.", "default": 0 }, "language": { "title": "Language", "type": "string", "description": "Interface language for names of regions, topics and dates, e.g. en-US, de, fr, ms.", "default": "en-US" }, "maxConcurrency": { "title": "Parallel lookups", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many terms to fetch at the same time. Higher is faster but Google may slow you down; the Actor backs off and retries automatically.", "default": 3 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify datacenter proxy (default) lets the Actor switch IP whenever Google rate-limits a request, so big runs finish fast. Residential proxies are not needed. If you turn it off the Actor backs off and falls back to datacenter proxies on its own.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }