Get interest-over-time, interest-by-region, and related topics/queries for any keyword, location, time range and Google surface, with side-by-side comparison for up to five keywords. Output fields: se
Get interest-over-time, interest-by-region, and related topics/queries for any keyword, location, time range and Google surface, with side-by-side comparison for up to five keywords.
vexaloom-labs~google-trends-interest-and-related-query-scraper)references/example-input.jsonreferences/input-schema.jsonreferences/output-fields.jsonShort video breakdown:
Use this skill when the user wants:
Do not use it for private, login-protected or paywalled data.
One JSON row per result. Columns from the Actor's dataset schema:
searchTerms: Termstitle: Trending termgeoName: LocationtimeRangeLabel: Time labelhoursLabel: WindowcategoryName: CategorysearchTypeLabel: Type labelaverageInterest: AvgvolumeText: VolumegrowthPercent: Growth %exploreUrl: URLtrendingUrl: Trends URLAll 36 declared fields: references/output-fields.json.
| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| mode | string | no | interest | What to scrape. 'Interest over time & related queries' is the Google Trends Explore view (keywords required). 'Trending now' lists what is spiking in a country right now. |
| searchTerms | array | no | | One or more search terms to analyze (mode=interest). Each term becomes its own dataset row, or enable Comparison mode to compare up to 5 terms side by side. |
| compareMode | boolean | no | false | Compare all search terms on one shared 0-100 scale in a single row (Google Trends comparison view, maximum 5 terms). Off means each term is scraped independently. |
| startUrls | array | no | | Paste Google Trends links to scrape them directly: explore links (trends.google.com/trends/explore?q=..., including www.google.com/trends/... |
| geo | string | no | | Country, state/region or metro area to analyze. Leave empty for worldwide. Trending Now uses the country part of this location. |
| timeRange | string | no | today 12-m | Time window for the interest data (mode=interest). 'now' ranges return minute-level points; 'today' ranges return day/week points. Choose 'Custom range' to enter exact dates below. |
| customDateRange | string | no | | Only used when 'Time range' = 'Custom range': 'YYYY-MM-DD YYYY-MM-DD' (e.g. '2024-01-01 2024-12-31') or 'YYYY-MM-DDTHH YYYY-MM-DDTHH' for hourly granularity. |
| category | string | no | 0 | Google Trends category filter (mode=interest). 0 = All categories. |
| searchType | string | no | | Which Google surface to query (mode=interest). Web Search is the default. |
| geoResolution | string | no | | Breakdown level for 'interest by region' (mode=interest). Auto lets Google pick the right level for the location; other levels are applied when the location supports them. |
| trendingHours | string | no | 24 | How far back the Trending Now list goes (mode=trending). |
| trendingCategory | string | no | all | Filter the Trending Now list to one of Google's trending categories (mode=trending). |
| includeTrendingNews | boolean | no | true | Attach news headlines, links and sources from Google's Trending RSS feed to trending items whose titles it covers (about ten highlighted stories per country, anywhere in the list). |
| maxItems | integer | no | 100 | Maximum dataset records per run: each interest row counts as one record, each trending item as one record. Remaining work stops once the limit is reached. |
Example:
{
"terms": [
"ai agents",
"n8n workflows"
],
"geo": "US",
"timeRange": "today 3-m",
"includeRelatedQueries": true
}
Set APIFY_TOKEN, then call the synchronous endpoint for small and medium runs (it waits up to 300 seconds):
curl -s -X POST "https://api.apify.com/v2/acts/vexaloom-labs~google-trends-interest-and-related-query-scraper/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d @references/example-input.json > output.json
Or with Node 18+: node scripts/run.mjs [input.json].
For large runs, start an async run and read its dataset when it finishes:
RUN=$(curl -s -X POST "https://api.apify.com/v2/acts/vexaloom-labs~google-trends-interest-and-related-query-scraper/runs" \
-H "Authorization: Bearer $APIFY_TOKEN" -H "Content-Type: application/json" \
-d @references/example-input.json)
RUN_ID=$(echo "$RUN" | jq -r '.data.id'); DATASET=$(echo "$RUN" | jq -r '.data.defaultDatasetId')
curl -s "https://api.apify.com/v2/actor-runs/$RUN_ID?waitForFinish=60" -H "Authorization: Bearer $APIFY_TOKEN" | jq -r '.data.status'
curl -s "https://api.apify.com/v2/datasets/$DATASET/items?format=json" -H "Authorization: Bearer $APIFY_TOKEN" > output.json
Weekly roundup of top Claude Code skills, MCP servers, and AI coding tips.