Google Trends Scraper

ENDPOINTS
GET/compare-geos

Compare Locations

Compare one keyword's interest across 2-5 countries, regions or US metros on one scale.

QUERY PARAMS

One search term or Google topic id (from /autocomplete), or a Google Trends explore link with one keyword.

Examples:

  • Term: super bowl
  • Topic id: /m/0dl567 (Taylor Swift)

2-5 comma-separated geo codes: countries, regions or US metros (see /geos). worldwide cannot be mixed with other geos.

Examples: US,GB,CA, US-CA,US-TX,US-NY

Time range. The resolution follows it: minutes for the past hour, hours for the past 7 days, days up to 90 days, weeks up to 5 years, months for all.

Default: past_12_months

Allowed values: past_hour, past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years, all (since 2004), a date range YYYY-MM-DD YYYY-MM-DD (from 2004-01-01), or an hour range of up to 7 days YYYY-MM-DDTHH YYYY-MM-DDTHH (UTC)

Google Trends category id that narrows the searches to one topic area (see /categories).

Default: 0 (all categories)

Examples: 71 (Food & Drink), 5 (Computers & Electronics), 20 (Sports)

Which Google search to measure.

Default: web

Allowed values: web, images, news, youtube, shopping

Language for names and labels: an ISO 639-1 code or a locale.

Default: en

Examples: en, de, ja, pt-BR

{
  "keyword": {
    "keyword": "taylor swift",
    "name": "taylor swift",
    "is_topic": false
  },
  "geos": [
    {
      "code": "US",
      "name": "United States"
    },
    {
      "code": "GB",
      "name": "United Kingdom"
    },
    {
      "code": "CA",
      "name": "Canada"
    }
  ],
  "timeframe": {
    "value": "past_12_months",
    "start": "2025-09-26",
    "end": "2026-09-26"
  },
  "category": {
    "id": 0,
    "name": "All categories"
  },
  "property": "web",
  "resolution": "week",
  "averages": {
    "US": 26,
    "GB": 16,
    "CA": 22
  },
  "timeline": [
    {
      "date": "2025-09-21",
      "values": {
        "US": 27,
        "GB": 24,
        "CA": 32
      },
      "is_partial": false
    },
    {
      "date": "2025-09-28",
      "values": {
        "US": 100,
        "GB": 71,
        "CA": 81
      },
      "is_partial": false
    },
    {
      "date": "2025-10-05",
      "values": {
        "US": 98,
        "GB": 56,
        "CA": 81
      },
      "is_partial": false
    },
    {
      "date": "2025-10-12",
      "values": {
        "US": 46,
        "GB": 28,
        "CA": 42
      },
      "is_partial": false
    },
    {
      "date": "2025-10-19",
      "values": {
        "US": 26,
        "GB": 16,
        "CA": 23
      },
      "is_partial": false
    },
    {
      "date": "2025-10-26",
      "values": {
        "US": 23,
        "GB": 15,
        "CA": 15
      },
      "is_partial": false
    },
    {
      "date": "2025-11-02",
      "values": {
        "US": 22,
        "GB": 13,
        "CA": 18
      },
      "is_partial": false
    },
    {
      "date": "2025-11-09",
      "values": {
        "US": 21,
        "GB": 18,
        "CA": 19
      },
      "is_partial": false
    },
    {
      "date": "2025-11-16",
      "values": {
        "US": 22,
        "GB": 15,
        "CA": 18
      },
      "is_partial": false
    },
    {
      "date": "2025-11-23",
      "values": {
        "US": 23,
        "GB": 13,
        "CA": 17
      },
      "is_partial": false
    },
    {
      "date": "2025-11-30",
      "values": {
        "US": 19,
        "GB": 12,
        "CA": 17
      },
      "is_partial": false
    },
    {
      "date": "2025-12-07",
      "values": {
        "US": 37,
        "GB": 25,
        "CA": 35
      },
      "is_partial": false
    },
    {
      "date": "2025-12-14",
      "values": {
        "US": 32,
        "GB": 23,
        "CA": 35
      },
      "is_partial": false
    },
    {
      "date": "2025-12-21",
      "values": {
        "US": 35,
        "GB": 23,
        "CA": 28
      },
      "is_partial": false
    },
    {
      "date": "2025-12-28",
      "values": {
        "US": 28,
        "GB": 20,
        "CA": 24
      },
      "is_partial": false
    },
    {
      "date": "2026-01-04",
      "values": {
        "US": 19,
        "GB": 12,
        "CA": 18
      },
      "is_partial": false
    },
    {
      "date": "2026-01-11",
      "values": {
        "US": 18,
        "GB": 12,
        "CA": 16
      },
      "is_partial": false
    },
    {
      "date": "2026-01-18",
      "values": {
        "US": 21,
        "GB": 13,
        "CA": 18
      },
      "is_partial": false
    },
    {
      "date": "2026-01-25",
      "values": {
        "US": 17,
        "GB": 11,
        "CA": 14
      },
      "is_partial": false
    },
    {
      "date": "2026-02-01",
      "values": {
        "US": 26,
        "GB": 20,
        "CA": 23
      },
      "is_partial": false
    },
    {
      "date": "2026-02-08",
      "values": {
        "US": 18,
        "GB": 13,
        "CA": 17
      },
      "is_partial": false
    },
    {
      "date": "2026-02-15",
      "values": {
        "US": 14,
        "GB": 9,
        "CA": 13
      },
      "is_partial": false
    },
    {
      "date": "2026-02-22",
      "values": {
        "US": 14,
        "GB": 9,
        "CA": 13
      },
      "is_partial": false
    },
    {
      "date": "2026-03-01",
      "values": {
        "US": 14,
        "GB": 11,
        "CA": 12
      },
      "is_partial": false
    },
    {
      "date": "2026-03-08",
      "values": {
        "US": 14,
        "GB": 8,
        "CA": 12
      },
      "is_partial": false
    },
    {
      "date": "2026-03-15",
      "values": {
        "US": 13,
        "GB": 9,
        "CA": 11
      },
      "is_partial": false
    },
    {
      "date": "2026-03-22",
      "values": {
        "US": 16,
        "GB": 10,
        "CA": 14
      },
      "is_partial": false
    },
    {
      "date": "2026-03-29",
      "values": {
        "US": 15,
        "GB": 9,
        "CA": 14
      },
      "is_partial": false
    },
    {
      "date": "2026-04-05",
      "values": {
        "US": 14,
        "GB": 10,
        "CA": 13
      },
      "is_partial": false
    },
    {
      "date": "2026-04-12",
      "values": {
        "US": 14,
        "GB": 9,
        "CA": 11
      },
      "is_partial": false
    },
    {
      "date": "2026-04-19",
      "values": {
        "US": 13,
        "GB": 8,
        "CA": 10
      },
      "is_partial": false
    },
    {
      "date": "2026-04-26",
      "values": {
        "US": 23,
        "GB": 15,
        "CA": 18
      },
      "is_partial": false
    },
    {
      "date": "2026-05-03",
      "values": {
        "US": 16,
        "GB": 9,
        "CA": 12
      },
      "is_partial": false
    },
    {
      "date": "2026-05-10",
      "values": {
        "US": 13,
        "GB": 8,
        "CA": 11
      },
      "is_partial": false
    },
    {
      "date": "2026-05-17",
      "values": {
        "US": 14,
        "GB": 8,
        "CA": 12
      },
      "is_partial": false
    },
    {
      "date": "2026-05-24",
      "values": {
        "US": 17,
        "GB": 10,
        "CA": 13
      },
      "is_partial": false
    },
    {
      "date": "2026-05-31",
      "values": {
        "US": 24,
        "GB": 17,
        "CA": 18
      },
      "is_partial": false
    },
    {
      "date": "2026-06-07",
      "values": {
        "US": 30,
        "GB": 11,
        "CA": 20
      },
      "is_partial": false
    },
    {
      "date": "2026-06-14",
      "values": {
        "US": 20,
        "GB": 10,
        "CA": 15
      },
      "is_partial": false
    },
    {
      "date": "2026-06-21",
      "values": {
        "US": 20,
        "GB": 9,
        "CA": 16
      },
      "is_partial": false
    },
    {
      "date": "2026-06-28",
      "values": {
        "US": 92,
        "GB": 52,
        "CA": 79
      },
      "is_partial": false
    },
    {
      "date": "2026-07-05",
      "values": {
        "US": 72,
        "GB": 38,
        "CA": 65
      },
      "is_partial": false
    },
    {
      "date": "2026-07-12",
      "values": {
        "US": 22,
        "GB": 11,
        "CA": 18
      },
      "is_partial": false
    },
    {
      "date": "2026-07-19",
      "values": {
        "US": 18,
        "GB": 10,
        "CA": 14
      },
      "is_partial": false
    },
    {
      "date": "2026-07-26",
      "values": {
        "US": 16,
        "GB": 10,
        "CA": 13
      },
      "is_partial": false
    },
    {
      "date": "2026-08-02",
      "values": {
        "US": 14,
        "GB": 9,
        "CA": 12
      },
      "is_partial": false
    },
    {
      "date": "2026-08-09",
      "values": {
        "US": 17,
        "GB": 10,
        "CA": 14
      },
      "is_partial": false
    },
    {
      "date": "2026-08-16",
      "values": {
        "US": 17,
        "GB": 11,
        "CA": 16
      },
      "is_partial": false
    },
    {
      "date": "2026-08-23",
      "values": {
        "US": 17,
        "GB": 9,
        "CA": 14
      },
      "is_partial": false
    },
    {
      "date": "2026-08-30",
      "values": {
        "US": 15,
        "GB": 9,
        "CA": 11
      },
      "is_partial": false
    },
    {
      "date": "2026-09-06",
      "values": {
        "US": 13,
        "GB": 8,
        "CA": 10
      },
      "is_partial": false
    },
    {
      "date": "2026-09-13",
      "values": {
        "US": 20,
        "GB": 9,
        "CA": 15
      },
      "is_partial": false
    },
    {
      "date": "2026-09-20",
      "values": {
        "US": 46,
        "GB": 31,
        "CA": 39
      },
      "is_partial": true
    }
  ]
}