Google Trends Keyword Snapshot

Track keyword interest on Google Trends with a fast, focused Apify Actor. Get interest-over-time data and related search queries by country or region in clean JSON dataset items.

What this Actor does

• Tracks up to 10 keywords in one run
• Returns one dataset item per unique keyword
• Collects Google Trends interest over time on a 0–100 scale
• Extracts related search queries and their relative values
• Supports country/region targeting such as US, GB, DE, and TR
• Supports time ranges from the past hour to the past 5 years
• Supports Web Search, Google News, Google Images, Google Shopping, and YouTube properties
• Uses lightweight HTTP requests without browser automation
• Supports Apify Proxy for repeated or higher-volume runs
• Produces API-friendly JSON output for SEO tools, content workflows, dashboards, and alerts

Why use Google Trends Keyword Snapshot?

Many trend workflows need only two things: historical search interest and the queries growing around a topic. This Actor focuses on those signals without adding unrelated profile, company, or page data. It is designed for quick keyword research, content planning, market monitoring, and automation.

Input

Field	Type	Default	Description
keywords	string array	["artificial intelligence"]	One to ten keywords to track
geo	string	US	Country or region code; use an empty value for worldwide data
timeRange	select	today 12-m	Google Trends period
category	integer	0	Google Trends category ID; 0 means all categories
property	select	Web Search	Web, News, Images, Shopping, or YouTube
proxyConfiguration	object	optional	Apify Proxy configuration

Example input

{
  "keywords": ["ai agents", "generative ai", "workflow automation"],
  "geo": "US",
  "timeRange": "today 12-m",
  "category": 0,
  "property": ""
}

Output

The Actor creates one dataset item per keyword. timeline contains the interest-over-time points returned by Google Trends. Values are relative to the selected period, where 100 is the peak interest for that keyword and 0 means insufficient data or no measurable interest.

{
  "keyword": "ai agents",
  "geo": "US",
  "timeRange": "today 12-m",
  "category": 0,
  "property": "",
  "timeline": [
    {
      "time": "1711929600",
      "formattedTime": "Apr 2024",
      "value": 42
    }
  ],
  "relatedQueries": [
    {
      "query": "ai agent tools",
      "value": 100,
      "formattedValue": "Breakout"
    }
  ],
  "sourceUrl": "https://trends.google.com/trends/explore?geo=US&q=ai%20agents",
  "success": true,
  "error": null
}

If one keyword fails, the Actor records success: false and the error for that keyword while continuing with the remaining keywords.

Use cases

• SEO keyword research and content calendars
• Discovering rising related queries
• Comparing demand signals across regions
• Monitoring a product category or market topic
• Building trend dashboards and newsletters
• Feeding Make, Zapier, Google Sheets, Airtable, or custom APIs
• Scheduling daily or weekly keyword snapshots

Pay-per-event pricing

This Actor is designed for usage-based billing: one successful or failed keyword snapshot equals one billable event. Configure the final event price in the Apify Console Store pricing settings. The Actor itself does not require a subscription or external API key.

Run with the Apify API

curl "https://api.apify.com/v2/acts/YOUR_USERNAME~google-trends-keyword-snapshot/runs" \\
  -X POST \\
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \\
  -H "Content-Type: application/json" \\
  -d '{
    "keywords": ["ai agents", "content marketing"],
    "geo": "US",
    "timeRange": "today 12-m",
    "category": 0,
    "property": ""
  }'

Local development

Requirements: Node.js 20 or newer.

npm install
npm run check
npm run test:live

To run the full Actor locally, place input JSON at storage/key_value_stores/default/INPUT.json and start it:

mkdir -p storage/key_value_stores/default
cp INPUT.example.json storage/key_value_stores/default/INPUT.json
npm start

Results are written to storage/datasets/default/.

Data source and limitations

• Data comes from Google Trends public web endpoints.
• Google Trends values are relative, not absolute search volume.
• Related queries and timeline points depend on the selected keyword, region, property, and period.
• Google may change public endpoint behavior or rate-limit repeated requests; Apify Proxy is recommended for scheduled or larger runs.
• No Google login, cookies, or private account data are used.
• This Actor is not affiliated with or endorsed by Google.

Responsible use

Use the Actor in accordance with Google’s terms, applicable laws, and your own data-use requirements. Do not use it to infer sensitive personal information about individuals.

License

MIT