How to use it: 3 steps
- Make a free Apify accountApify is the cloud platform where our tools run. The free plan gives you $5 of usage every month, no credit card needed. You pay Apify, not us.
- Paste your input and press StartNo code needed: you fill in a form (the input). It already has a working example. For example:
web scrapingin Search terms. Each start is one run. - Download the resultsWhen the run ends, the results are in a table (the dataset). Open Output, press Export and pick Excel or CSV. JSON and the API are there too.
This tool is an Apify Actor: a small program that runs on Apify. You can also run it on a schedule, for example every Monday. New to it? Read how it works, step by step and the 8 words you need first.
What it does
Google Trends Scraper gets Google Trends data for your keywords: interest over time, interest by country, region, metro or city, and related queries and topics. Add one or more search terms, pick a location and a time range, and the Actor returns clean rows that you can open as a table, export to CSV or Excel, or read with the API.
- Interest over time: one row per time point with a value from 0 to 100 (100 = the highest interest in the chosen period and place).
- Interest by region: one row per country, region, US metro area or city that has data.
- Related queries: top and rising searches that people also made.
- Related topics: top and rising topics, only when Google sends them.
- Summary: one row per term with its status, average interest and row counts.
Good for
- Check how interest in a product, brand or topic changes over months or years.
- Find the countries or US states where a term is most popular.
- Collect rising queries for content and SEO ideas.
- Compare up to 5 brands or keywords on one scale.
Not a good fit
- Google Trends shows relative interest (0–100), not the number of searches. It is not a keyword volume tool.
- It does not collect "Trending now" daily trends or real-time trending stories.
- Google gives no region data for some terms and filters (for example many terms at city level). The Actor then returns the other sections and explains it in a warning.
- Related topics: in our tests in October 2026, Google sent empty topic lists for most terms. The Actor returns topics only when Google sends them.
Who uses it
Product teams
Check the season when people search for your product.
Marketers
Find the countries or US states where a term is most popular.
Content creators
Collect rising queries for new article or video ideas.
Price
Pay per event: you pay for each result the tool saves, plus a small start fee for each run. The price includes Apify platform costs. Apify bills you, not us. Prices below are for the Apify free plan.
| What you pay for | Price | When |
|---|---|---|
| Start fee | $0.01 | Charged once per run. This tool uses 1 GB of memory or less by default; more memory costs more. |
| Data row | $0.00005 (from $0.000043 on paid Apify plans) | Charged for each data row of a keyword with data: one point of interest over time, one region, or one related query or topic. The same count applies in grouped output. Per-keyword summary rows and keywords without enough search data or with an error are free. |
Examples
- One result: about $0.01.
- 1,000 results: about $0.06.
- Every day 100 results, for 30 days: about $0.45 a month.
Free to try: the Apify free plan gives you $5 of usage every month, no credit card needed. That is enough for about 83,000 results.
Prices checked on 24 October 2026. See the current price on Apify.
Questions
Does Google Trends show the number of searches?
No. It shows interest from 0 to 100. 100 is the top point for that term, place and time.
Why are numbers a bit different each day?
Google Trends uses a sample of searches. Small changes between runs are normal.
Does it get daily trending searches?
No. It does not collect Trending now lists or trending stories.
How many keywords can I check?
Up to 50 terms per run. 50 terms took about 110 seconds in tests.
Do I need a Google account or an API key?
No. The Actor reads public Google Trends data without login.
Is this the number of searches?
No. Google Trends gives relative interest from 0 to 100. 100 is the highest point for the chosen term, place and period. It does not show search volume.
Why are the numbers a little different from yesterday?
Google Trends uses a sample of searches and rescales each query. Small changes between runs are normal, mostly for small terms and short periods.
Why are there no related topics?
Google sends related topics only for single terms (not for comparisons), and in our tests in October 2026 the topic lists were often empty. The Actor returns topics only when Google sends them.
Why does a small country have 100?
Region values are the share of all searches in that place, not the number of searches. A small country with few searches can get 100. This is how Google Trends shows it; the Actor does not change values. Rising values like 23350 (+23,350%) and "Breakout" also come from Google.
How fresh is the data?
Each run asks Google Trends at the time of the run. The latest time point is often not finished yet (isPartial true).
Details
Step by step on Apify
- Open the Input tab.
- Keep the prefilled term
web scrapingin Search terms, or add your own terms (up to 50). - Keep Time range at Past 12 months, or choose another period. Leave Location empty for worldwide data.
- Click Start.
- Open the Output tab. Every row has a
recordTypecolumn:interest_over_time,interest_by_region,related_query,related_topicorterm_summary. Sort or filter by this column, or export and filter in a spreadsheet.
Use cases
| Task | Input | You get | Key fields | Next step |
|---|---|---|---|---|
| Seasonality of a product | searchTerms, timeRange today 5-y | time rows | date, value, isPartial | chart in Google Sheets or BI |
| Where to launch | searchTerms, regionResolution | region rows | geoName, geoCode, value | map or market list |
| Content and SEO ideas | searchTerms, includeRelated | related query rows | query, rankType, value, isBreakout | keyword list |
| Brand comparison | searchTerms (2–5) + compareTerms | time and region rows | value, comparisonShare, comparisonGroup | dashboard |
| News and YouTube interest | searchType news or youtube | time rows | date, value | report |
Tips for better results
- Use the compare option to put up to 5 terms on one scale.
- Do not compare values from separate queries; they use different scales.
- Use a long time range for small terms; short ones jump more.
Limits and good to know
- Up to 50 terms per run. 50 terms took about 110 seconds in our tests
- Up to 5 terms in one comparison (Google Trends limit)
- Values are relative (0–100) inside one query. Values of terms from separate queries are not on the same scale; use
compareTermsfor that - A run works for up to about 4.5 minutes with the default 300-second timeout. If it has more terms, it stops with the rows it has and
RUN_SUMMARYshowsCAPPEDwithDEADLINE - A
partialterm is charged for the rows it has.statusReasontells you which section is missing - If Google refuses many requests, the Actor first switches to new connections and then to residential proxies. If Google still refuses, the run stops; terms that were not done get free
errorrows
For developers
Sample result
One result from a real test run, in JSON. Real values change from run to run. In Excel or CSV each field is a column.
[
{
"recordType": "interest_over_time",
"searchTerm": "web scraping",
"date": "2025-10-12T00:00:00.000Z",
"formattedTime": "Oct 12 – 18, 2025",
"value": 56,
"hasData": true,
"isPartial": false
},
{
"recordType": "interest_by_region",
"searchTerm": "web scraping",
"geoCode": "US",
"geoName": "United States",
"value": 50,
"formattedValue": "50",
"comparisonShare": null,
"latitude": null,
"longitude": null,
"regionResolution": "COUNTRY"
},
{
"recordType": "related_query",
"searchTerm": "web scraping",
"rankType": "top",
"query": "web data scraping",
"value": 100,
"formattedValue": "100",
"isBreakout": false,
"link": "https://trends.google.com/trends/explore?q=web+data+scraping&date=today+12-m"
},
{
"recordType": "term_summary",
"searchTerm": "web scraping",
"exploreUrl": "https://trends.google.com/trends/explore?date=today+12-m&q=web+scraping&hl=en-US",
"status": "complete",
"statusReason": null,
"errorCode": null,
"average": 58,
"timelinePoints": 53,
"regionRows": 65,
"relatedQueryRows": 45,
"relatedTopicRows": 0
}
]Use it from code
Actor ID: cliqtomedia/google-trends-scraper. You need your Apify API token from Apify Console → Settings → API & Integrations.
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("cliqtomedia/google-trends-scraper").call(run_input={
"searchTerms": [
"web scraping"
],
"compareTerms": False
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)curl -X POST "https://api.apify.com/v2/acts/cliqtomedia~google-trends-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"searchTerms": ["web scraping"], "compareTerms": false}'# pip install langchain-apify
# set APIFY_TOKEN in your environment
from langchain_apify import ApifyActorsTool
tool = ApifyActorsTool("cliqtomedia/google-trends-scraper")
result = tool.invoke({"run_input": {"searchTerms": ["web scraping"], "compareTerms": False}})
print(result)The cURL call waits for the results, up to 300 seconds. For longer runs, start a run (/runs) and get the results with a webhook or by checking the run. Apify API docs. LlamaIndex, MCP for AI agents and the JavaScript client: AI agents & MCP.
Data fields (40)
| Field | Type | Meaning |
|---|---|---|
recordType | string | What the row holds: a time point, a region, a related query or topic, the per-term summary (rows format) or one whole term (grouped format). |
searchTerm | string | The search term the row belongs to. |
comparisonGroup | string | All compared terms joined by " | " when "Compare terms" is on; otherwise null. |
geo | string | Location code, or WORLDWIDE. |
timeRange | string | Time range sent to Google, e.g. "today 12-m" or "2024-01-01 2024-06-30". |
categoryId | integer | Google Trends category id (0 = all categories). |
searchType | string | web, images, news, shopping or youtube. |
exploreUrl | string | The same query in the Google Trends UI. |
sourceUrl | string | Google Trends API endpoint the data came from. |
fetchedAt | string | When the data was fetched (ISO 8601, UTC). |
date | string | Start of the time point (ISO 8601, UTC). |
formattedTime | string | Time point label as Google shows it. |
value | integer | Interest 0–100 (time point or region) or related-item score; null when Google has no data — never 0 in place of missing. |
hasData | boolean | False when Google has no data for this time point. |
isPartial | boolean | True for the latest, still incomplete time point. |
geoCode | string | Region code (e.g. US-CA, or the metro number). |
geoName | string | Region name. |
formattedValue | string | Value as Google shows it, e.g. "<1", "+250%" or "Breakout". |
comparisonShare | integer | Comparison only: the term's share (%) of searches among the compared terms in this region. |
latitude | number | City level only: latitude. |
longitude | number | City level only: longitude. |
regionResolution | string | Region level of the region rows: COUNTRY, REGION, DMA or CITY. |
rankType | string | top = most searched with the term; rising = biggest growth. |
query | string | Related query text. |
topicTitle | string | Related topic name. |
topicType | string | Related topic type, e.g. "Programming language". |
topicMid | string | Google Knowledge Graph id of the topic. |
isBreakout | boolean | True when Google marks the rising item as Breakout (growth over 5000%). |
link | string | Google Trends link for the related item. |
status | string | Term result: complete, partial (some sections missing), not_found (not enough search data) or error. Only data rows of complete and partial terms are charged. |
statusReason | string | Why a term is partial, not_found or error. |
errorCode | string | Machine-readable error code for partial and error terms. |
average | integer | Average interest over the period (null when unknown). |
timelinePoints | integer | Number of time points received for the term. |
regionRows | integer | Region rows written for the term. |
relatedQueryRows | integer | Related query rows written for the term. |
relatedTopicRows | integer | Related topic rows written for the term. |
interestOverTime | array | Grouped format: time points. |
interestByRegion | array | Grouped format: regions with data. |
relatedQueriesTop | array | Grouped format: top related queries. |
Input settings (15)
The main fields of the input form. With the API you send them as JSON.
| Setting | Name in the API | Type | Example value |
|---|---|---|---|
| Search terms required | searchTerms | array | ["web scraping"] |
| Compare terms on one chart | compareTerms | boolean | false |
| Location | geo | string | |
| Time range | timeRange | string | "today 12-m" |
| Custom time range | customTimeRange | string | |
| Category | category | string | "0" |
| Category ID (advanced) | categoryId | integer | |
| Search type | searchType | string | "web" |
| Interest over time | includeTimeline | boolean | true |
| Interest by region | includeRegions | boolean | true |
| Region level | regionResolution | string | "auto" |
| Include low search volume regions | includeLowVolumeRegions | boolean | false |
| Related queries and topics | includeRelated | boolean | true |
| Output format | outputFormat | string | "rows" |
| Proxy | proxyConfiguration | object | {"useApifyProxy": true} |
Use cases with this tool
Each guide shows all the steps and the other tools.