The Google Trends Scraper collects interest-over-time data for specific search keywords, based on location and date range. It returns a time series showing how popularity changes over time, directly from Google Trends.

This scraper job is asynchronous. You’ll receive a jobId, and can fetch results via polling or webhook delivery.

Example Request

curl --request POST \
  --url 'https://api.hasdata.com/scrapers/google-trends/jobs' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <your-api-key>' \
  --data '{
    "keywords": ["chatgpt", "openai"],
    "location": "US",
    "date": "today 12-m"
  }'

Job Parameters

keywords
string[]
required

List of search terms to track interest over time, e.g. ["ai tools", "machine learning"]

location
string
required

Two-letter country code or worldwide for global results. Examples:

  • US — United States
  • DE — Germany
  • IN — India
  • BR — Brazil
  • worldwide — Global trends across all regions
date
string
required

Time range to analyze. Supported values:

  • now 1-H — Past hour
  • now 4-H — Past 4 hours
  • now 1-d — Past day
  • now 7-d — Past 7 days
  • today 1-m — Past 30 days
  • today 3-m — Past 90 days
  • today 12-m — Past 12 months
  • today 5-y — Past 5 years
  • all — From 2004 to present

Getting Results

Webhooks

Receive real-time updates when your scraper job starts, completes, or collects data.

Results API

Use the Results API to fetch your data using the jobId, with support for polling and pagination.

Stopping a Job

Cancel an active scraper job early if it’s no longer needed or you want to save credits.