{ "openapi": "3.0.1", "info": { "title": "Google Trends Scraper: Interest, Rising Queries & Trending Now", "description": "Google Trends without a browser or API key: interest over time with average, peak and change, interest by state, metro or city, top and rising related queries, more than 5 terms compared on one scale, and the full Trending now list with search volumes.", "version": "0.1", "x-build-id": "MeuthbS37eTKwwnUL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/roomy_tweet~google-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-roomy_tweet-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/roomy_tweet~google-trends-scraper/runs": { "post": { "operationId": "runs-sync-roomy_tweet-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/roomy_tweet~google-trends-scraper/run-sync": { "post": { "operationId": "run-sync-roomy_tweet-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": "What to look up on Google Trends, one term per line. Each term gets its own result (its own 0–100 scale) unless you turn on \"Compare terms on one scale\". A Google topic ID such as /m/05p0rrx also works.", "items": { "type": "string" } }, "startUrls": { "title": "Google Trends URLs", "type": "array", "description": "Optional. Paste pages from trends.google.com: an Explore page (/trends/explore?q=…, up to 5 terms compared, with its own location, time range, category and property) or Trending now (/trending?geo=…).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "geos": { "title": "Locations", "type": "array", "description": "Country codes (US, BR, GB), regions (US-CA, BR-SP) or US metros (US-CA-807). Every term runs in every location. Leave empty for worldwide.", "items": { "type": "string" } }, "timeRange": { "title": "Time range", "enum": [ "past-hour", "past-4-hours", "past-day", "past-7-days", "past-30-days", "past-90-days", "past-12-months", "past-5-years", "since-2004", "custom" ], "type": "string", "description": "The period of the interest over time chart. Google picks the point size: hourly up to 7 days, daily up to 9 months, weekly up to 5 years, monthly beyond.", "default": "past-12-months" }, "startDate": { "title": "Start date (custom range)", "type": "string", "description": "Only with the custom time range. 2004-01-01 or later." }, "endDate": { "title": "End date (custom range)", "type": "string", "description": "Only with the custom time range." }, "compareTerms": { "title": "Compare terms on one scale", "type": "boolean", "description": "Put all search terms on one 0–100 scale, as Google's Compare button does, and add each term's share of the total. Google compares at most 5 terms at once; for more, an anchor term links the requests (see the README).", "default": false }, "category": { "title": "Category", "type": "string", "description": "Optional. Narrow the searches to a Google Trends category, by name (\"Food & Drink\", \"Finance\") or ID (71). Empty = all categories." }, "searchProperty": { "title": "Google property", "enum": [ "web", "images", "news", "youtube", "shopping" ], "type": "string", "description": "Which searches to count: web search, image search, news search, YouTube search or Google Shopping.", "default": "web" }, "interestOverTime": { "title": "Interest over time", "type": "boolean", "description": "The chart as points (date, value 0–100), plus average, peak, latest value and change.", "default": true }, "interestByRegion": { "title": "Interest by region", "type": "boolean", "description": "Where the term is searched most, relative to all searches in each place (0–100).", "default": true }, "regionResolution": { "title": "Region level", "enum": [ "default", "COUNTRY", "REGION", "DMA", "CITY" ], "type": "string", "description": "Google's default is countries for worldwide and states/provinces for a country. Metros (DMA) exist for the US only.", "default": "default" }, "relatedQueries": { "title": "Related queries", "type": "boolean", "description": "Top and rising searches made together with the term, with growth in percent and Breakout flags.", "default": true }, "relatedTopics": { "title": "Related topics", "type": "boolean", "description": "Off by default: in October 2026 Google returned no related topics for any search we tried, on its own website too. Turn on to get them if Google brings them back (single terms only, not comparisons).", "default": false }, "trendingGeos": { "title": "Trending now locations", "type": "array", "description": "Country codes (US, BR, GB...) to save every search trending there right now, with search volume, growth, start time, categories and related searches. Leave empty to skip.", "items": { "type": "string" } }, "trendingHours": { "title": "Trending in the past", "enum": [ "4", "24", "48", "168" ], "type": "string", "description": "The window Trending now covers.", "default": "24" }, "trendingCategories": { "title": "Trending categories", "type": "array", "description": "Optional. Keep only trends in these categories.", "items": { "type": "string", "enum": [ "1", "2", "3", "20", "4", "5", "6", "7", "8", "9", "10", "11", "13", "14", "15", "16", "17", "18", "19" ], "enumTitles": [ "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": "Only trends still active", "type": "boolean", "description": "Leave out trends Google marks as ended.", "default": false }, "maxTrendsPerGeo": { "title": "Max trending searches per location", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Google lists them by relevance; the first ones are kept.", "default": 100 }, "language": { "title": "Language", "type": "string", "description": "Language of region and topic names (en-US, pt-BR, es, de...). Search data does not change.", "default": "en-US" }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after saving this many results (term results and trending searches together).", "default": 10000 }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many terms are fetched at the same time.", "default": 3 }, "maxDurationSecs": { "title": "Time limit (seconds)", "minimum": 60, "maximum": 3600, "type": "integer", "description": "Terms not started by then are skipped (status SKIPPED in the report).", "default": 1800 }, "failOnQualityDrop": { "title": "Fail the run on a quality drop", "type": "boolean", "description": "Mark the run as failed when the quality check finds a problem (every term failing, Google's response changing, Trending now empty), so scheduled runs alert you.", "default": false } } }, "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 } } } } } } } } } }