Scrape data from Google Trends by search terms or URLs. Specify locations, define time ranges, select categories to get interest by subregion and over time, related queries and topics, and more. Export scraped data, run the scraper via API, schedule and monitor runs, or integrate with other tools.
Get results from a specific geo area (defaults to 'Worldwide'). This maps to different fields in the dataset results: smaller countries like Greece return just 'interestByCity' data, while larger ones like the United States return 'interestBySubregion' data as well. When omitted (Worldwide), 'interestBy' is returned instead, which corresponds to the 'Interest by area' section on Google Trends. Note: When using Google Trends URLs from the '🔗 Use a Google Trends URL instead of search terms' section, the geo parameter from the URL's query string takes precedence over this setting. You can also use start URLs to retrieve 'interestByMetro' data for metropolitan areas by providing URLs with more specific geo regions like California (US) directly copied from Google Trends.
By default snapshot of each visited Google Trends page saved to KV Store
Default value of this property is false
Google Trends URLs
startUrlsarrayOptional
Copy a Google Trends URL and paste it here.
Google sheet ID (To get input data from Google sheet)
spreadsheetIdstringOptional
(Optional) Id of the google sheet from where search terms will be loaded.
Spreadsheet must have only one column. Row 1 is considered the title of the column so it will not be loaded as a search term. The provided spreadsheet must be publicly available. Check the actor documentation for more info.
Category of trends
categoryEnumOptional
Choose a category to filter the search for (defaults to 'All categories')
Limit of product items to be scraped. Zero value means no limit.
Default value of this property is 0
Custom time range
customTimeRangestringOptional
Provide custom time range. If present, it takes precedence over regular timeRange. Format is: YYYY-MM-DD YYYY-MM-DD. See examples in the documentation.
Max concurrency
maxConcurrencyintegerOptional
How many pages will be opened in parallel if enough CPU is available.
Default value of this property is 10
Max request retries
maxRequestRetriesintegerOptional
How many times will the actor retry a request if it fails.
Default value of this property is 7
Page load timeout
pageLoadTimeoutSecsintegerOptional
How long it will wait for page loading before it abandons the loading and tries again.