# Google Trends Scraper - Fast, No Browser (`vp916/google-trends-fast`) Actor Interest over time, by region, related queries (top + rising), comparisons of up to 5 terms, and Trending Now searches with volume and news. Direct API, no browser. - **URL**: https://apify.com/vp916/google-trends-fast.md - **Developed by:** [TrendLab Tools](https://apify.com/vp916) (community) - **Security:** Limited permissions - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 searches This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Google Trends Scraper - Fast, No Browser Get Google Trends data in seconds: **interest over time**, **interest by region**, **related queries (top + rising)**, **comparisons of up to 5 terms**, and **Trending Now** searches for any country with search volume, growth and news. This Actor talks to Google Trends directly instead of opening a browser for every keyword. That makes it fast (40 searches in under a minute) and cheap, and you only pay per search. ### What you get | Data | Details | |---|---| | Interest over time | 0-100 interest for every hour, day, week or month in your range. Averages included. | | Interest by region | Countries, states, cities or US metro areas (DMA). | | Related queries | Top and rising queries for every term, including **Breakout** ones. | | Comparisons | Compare up to 5 terms on one line, exactly like the Google Trends website. | | Trending Now | Everything trending in a country right now (often 300-700 searches): search volume, % increase, start time, still active or not, category, related searches, and news for the top stories. | | Filters | Any country or region, any time range (or custom dates), category, and search type: web, images, news, Google Shopping or YouTube. | ### How to use it 1. Add your **search terms**, one per line. To compare terms, put them on one line separated by commas: `iphone, samsung, pixel`. 2. Pick a **country** (`US`, `IN`, `GB`...) or leave it empty for worldwide. 3. Pick a **time range**. 4. Optional: add countries under **Trending now**. 5. Click **Start**. Download results as JSON, CSV, Excel, or use the API. Want it in a spreadsheet? Set **Output format** to *One row per data point*. Every date, region and related query becomes its own row. ### Input example ```json { "searchTerms": ["chatgpt", "iphone, samsung"], "geo": "IN", "timeRange": "today 3-m", "trendingNowGeos": ["US", "IN"] } ``` ### Output example One item per search (trimmed, real output): ```json { "searchTerms": ["chatgpt"], "geo": "IN", "timeRange": "today 12-m", "trendsUrl": "https://trends.google.com/trends/explore?q=chatgpt&date=today%2012-m&geo=IN", "interestOverTime": [ { "date": "2025-11-02", "timestamp": 1762041600, "isPartial": false, "values": { "chatgpt": 79 } } ], "averages": { "chatgpt": 76 }, "interestByRegion": [ { "geoCode": "IN-PY", "geoName": "Puducherry", "values": { "chatgpt": 100 } } ], "relatedQueries": { "chatgpt": { "top": [ { "query": "ai chatgpt", "value": 100, "formattedValue": "100" }, { "query": "chatgpt login", "value": 74, "formattedValue": "74" } ], "rising": [ { "query": "1980s photo prompt chatgpt", "value": 5750, "formattedValue": "Breakout" }, { "query": "1980s ai photo prompt chatgpt", "value": 2300, "formattedValue": "+2,300%" } ] } }, "scrapedAt": "2026-11-03T13:52:05Z" } ``` In a comparison (`iphone, samsung`), every point and region has one value per term: ```json { "date": "2026-08-03", "values": { "iphone": 26, "samsung": 13 } } { "geoCode": "IN-PB", "geoName": "Punjab", "values": { "iphone": 67, "samsung": 33 } } ``` A Trending Now item: ```json { "type": "trendingNow", "title": "us midterm elections results", "geo": "IN", "searchVolume": 50000, "increasePercent": 1000, "startedAt": "2026-11-03T02:10:00Z", "isActive": true, "categories": ["Politics"], "relatedQueries": ["us election results", "midterm elections 2026", "donald trump"], "news": [], "exploreUrl": "https://trends.google.com/trends/explore?q=us%20midterm%20elections%20results&geo=IN&date=now%201-d" } ``` ### Pricing Pay per event, no subscription: - **Per search** (one line of search terms, up to 5 compared terms): see the Pricing tab. - **Per Trending Now search** returned: see the Pricing tab. Platform usage is included, so there is nothing else to pay for. You can set a maximum cost per run, and the Actor stops when it is reached. ### Use cases - **SEO and content**: find rising and breakout queries before your competitors. - **E-commerce**: check seasonality and which states want your product. - **Market research**: compare brands, products or candidates over time. - **News and social media**: catch what is trending in any country right now. - **Data science**: feed clean time series into dashboards and models. ### FAQ **Why are the numbers 0-100?** Google Trends shows relative interest, not raw search counts. 100 is the peak for the selected terms, place and time. In comparisons, all terms share the same scale. For interest by region in comparisons, Google returns each term's share in that region. **Where are related topics?** Google does not return related topics to automated tools, so this Actor gives related queries only. **Why does my search have no data?** Google hides data for terms with very low search volume. Try a broader term, a bigger region or a longer time range. **Is it legal to scrape Google Trends?** This Actor only collects publicly available, aggregated Google Trends data. It does not collect personal data. Check that your use case follows the laws and terms that apply to you. **Something broke or you need a feature?** Open an issue in the Issues tab. I usually reply within a day. # Actor input Schema ## `searchTerms` (type: `array`): One search per line. To compare up to 5 terms like Google Trends does, put them on one line separated by commas, e.g. iphone, samsung, pixel. ## `geo` (type: `string`): Country code like US, IN, GB, or a region like US-CA, IN-MH. Leave empty for worldwide. ## `timeRange` (type: `string`): Period to analyse. Short ranges give hourly or daily points, long ranges give weekly or monthly points. ## `customTimeRange` (type: `string`): Overrides the time range above. Format: 2025-01-01 2025-06-30. ## `category` (type: `integer`): Google Trends category ID. 0 = all categories. Examples: 5 = Computers & Electronics, 7 = Finance, 18 = Shopping, 45 = Health. You can copy it from the cat= part of a Google Trends URL. ## `searchType` (type: `string`): Which Google property to measure: web, images, news, Google Shopping or YouTube. ## `includeInterestOverTime` (type: `boolean`): Search interest (0-100) for each date in the time range. ## `includeInterestByRegion` (type: `boolean`): Search interest for each country, state, city or metro area. ## `regionResolution` (type: `string`): Level of detail for interest by region. Cities and metros only work for some countries. ## `includeLowSearchVolumeRegions` (type: `boolean`): Also return regions where Google has very little data. ## `includeRelatedQueries` (type: `boolean`): Top and rising searches related to each term, including "Breakout" ones. ## `trendingNowGeos` (type: `array`): Country codes like US, IN, GB. Leave empty to skip. ## `trendingNowHours` (type: `string`): How recent the trending searches should be. ## `trendingNowMaxItems` (type: `integer`): 0 = all (often 300+). ## `outputFormat` (type: `string`): Nested is one tidy item per search. Flat gives one row per date, region or related query, ready for Excel and Google Sheets. ## `language` (type: `string`): Language for Google Trends results, e.g. en-US, hi, de. ## `proxyConfiguration` (type: `object`): Apify Proxy rotates IPs if Google slows down requests. The default works for almost everyone. ## `maxConcurrency` (type: `integer`): How many searches to run at the same time. Higher is faster but Google may slow down responses. ## `maxRetries` (type: `integer`): How many times to retry a request if Google slows down or fails. ## Actor input object example ```json { "searchTerms": [ "chatgpt", "iphone, samsung" ], "geo": "US", "timeRange": "today 12-m", "category": 0, "searchType": "web", "includeInterestOverTime": true, "includeInterestByRegion": true, "regionResolution": "auto", "includeLowSearchVolumeRegions": false, "includeRelatedQueries": true, "trendingNowGeos": [], "trendingNowHours": "24", "trendingNowMaxItems": 0, "outputFormat": "nested", "language": "en-US", "proxyConfiguration": { "useApifyProxy": true }, "maxConcurrency": 3, "maxRetries": 6 } ``` # Actor output Schema ## `searches` (type: `string`): One item per search line: interest over time, averages, interest by region and related queries (top + rising). ## `trending` (type: `string`): Trending Now searches per country: search volume, increase %, start time, category, related searches and news. ## `allItems` (type: `string`): Every item in the dataset as JSON, including flat rows when Output format is set to one row per data point. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchTerms": [ "chatgpt", "iphone, samsung" ], "geo": "US", "trendingNowGeos": [], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("vp916/google-trends-fast").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchTerms": [ "chatgpt", "iphone, samsung", ], "geo": "US", "trendingNowGeos": [], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("vp916/google-trends-fast").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchTerms": [ "chatgpt", "iphone, samsung" ], "geo": "US", "trendingNowGeos": [], "proxyConfiguration": { "useApifyProxy": true } }' | apify call vp916/google-trends-fast --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,vp916/google-trends-fast" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/eM3jVzC1UzIuIJyfe/builds/lnHUo36sNI6yWDsL4/openapi.json