Google Trends Scraper

ENDPOINTS
GET/interest-by-region

Interest by Region

Get search interest by country, region, city or US metro: 0-100 per keyword, or each keyword's share.

QUERY PARAMS

Up to 5 comma-separated search terms or Google topic ids (from /autocomplete), or a Google Trends explore link. A link's geo, date, cat and gprop also fill geo, timeframe, category and property when you leave those out.

Examples:

  • Terms: chatgpt,gemini,claude
  • Topic id: /m/0dl567 (Taylor Swift)
  • Link: https://trends.google.com/trends/explore?q=chatgpt&geo=US

Breakdown level. Worldwide data breaks down by country or city; a country by region, city or, in the US only, metro (DMA); a region by city or metro; a metro by city.

Default: the next level below geo

Allowed values: country, region, city, metro

Also return places with too little search volume to rate (their values come back null).

Default: false

Where to measure: a country, a region, a US metro area (DMA) or worldwide (see /geos for every code). A trends.google.com link with ?geo= works too.

Default: worldwide

Examples: US, US-CA (California), US-CA-803 (Los Angeles), GB-ENG (England)

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

{
  "keywords": [
    {
      "keyword": "pickleball",
      "name": "pickleball",
      "is_topic": false
    }
  ],
  "geo": {
    "code": null,
    "name": "Worldwide"
  },
  "timeframe": {
    "value": "past_12_months",
    "start": "2025-09-26",
    "end": "2026-09-26"
  },
  "category": {
    "id": 0,
    "name": "All categories"
  },
  "property": "web",
  "link": "https://trends.google.com/trends/explore?q=pickleball&date=today%2012-m",
  "resolution": "country",
  "value_type": "interest",
  "count": 34,
  "regions": [
    {
      "code": "PH",
      "name": "Philippines",
      "values": {
        "pickleball": 100
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "SG",
      "name": "Singapore",
      "values": {
        "pickleball": 77
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "VN",
      "name": "Vietnam",
      "values": {
        "pickleball": 72
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "MY",
      "name": "Malaysia",
      "values": {
        "pickleball": 70
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "HK",
      "name": "Hong Kong",
      "values": {
        "pickleball": 54
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "CA",
      "name": "Canada",
      "values": {
        "pickleball": 52
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "US",
      "name": "United States",
      "values": {
        "pickleball": 46
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "AU",
      "name": "Australia",
      "values": {
        "pickleball": 35
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "PR",
      "name": "Puerto Rico",
      "values": {
        "pickleball": 28
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "NZ",
      "name": "New Zealand",
      "values": {
        "pickleball": 27
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "GB",
      "name": "United Kingdom",
      "values": {
        "pickleball": 11
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "SH",
      "name": "St. Helena",
      "values": {
        "pickleball": 10
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "IE",
      "name": "Ireland",
      "values": {
        "pickleball": 7
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "AE",
      "name": "United Arab Emirates",
      "values": {
        "pickleball": 7
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "KR",
      "name": "South Korea",
      "values": {
        "pickleball": 7
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "IN",
      "name": "India",
      "values": {
        "pickleball": 7
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "TH",
      "name": "Thailand",
      "values": {
        "pickleball": 6
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "NL",
      "name": "Netherlands",
      "values": {
        "pickleball": 6
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "ES",
      "name": "Spain",
      "values": {
        "pickleball": 5
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "TW",
      "name": "Taiwan",
      "values": {
        "pickleball": 5
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "BE",
      "name": "Belgium",
      "values": {
        "pickleball": 4
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "CH",
      "name": "Switzerland",
      "values": {
        "pickleball": 4
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "FR",
      "name": "France",
      "values": {
        "pickleball": 4
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "DE",
      "name": "Germany",
      "values": {
        "pickleball": 3
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "SE",
      "name": "Sweden",
      "values": {
        "pickleball": 3
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "ZA",
      "name": "South Africa",
      "values": {
        "pickleball": 3
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "ID",
      "name": "Indonesia",
      "values": {
        "pickleball": 3
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "MX",
      "name": "Mexico",
      "values": {
        "pickleball": 3
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "IT",
      "name": "Italy",
      "values": {
        "pickleball": 2
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "BR",
      "name": "Brazil",
      "values": {
        "pickleball": 2
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "AR",
      "name": "Argentina",
      "values": {
        "pickleball": 2
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "JP",
      "name": "Japan",
      "values": {
        "pickleball": 1
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "PL",
      "name": "Poland",
      "values": {
        "pickleball": 1
      },
      "top_keyword": null,
      "coordinates": null
    },
    {
      "code": "TR",
      "name": "Türkiye",
      "values": {
        "pickleball": 1
      },
      "top_keyword": null,
      "coordinates": null
    }
  ]
}