Google Search Scraper

ENDPOINTS
GET/trends/interest-by-region

Interest by Region

Google Trends interest (0-100) by country, region, city or metro area for up to 5 keywords.

QUERY PARAMS

Up to 5 comma-separated search terms to compare (case kept).

Examples:

  • One: python
  • Compare: python,javascript

Geographic level of the breakdown. Worldwide (no country) always breaks down by country; dma (metro areas) is US-only.

Default: region

Allowed values: country, region, city, dma

Maximum number of places to return.

Default: 100

Allowed values: 1-500

Time range of the data, or a custom YYYY-MM-DD YYYY-MM-DD range.

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, or YYYY-MM-DD YYYY-MM-DD

2-letter country to limit the data to. Omit for worldwide.

Allowed values: any ISO 3166-1 alpha-2 code (US, GB, IN, ...)

Google Trends category id to narrow the data (e.g. 5 = Computers & Electronics). Omit for all categories.

Allowed values: 1-2000

Which Google property's searches to measure.

Default: web

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

Language of topic names and labels.

Default: en

Allowed values: any ISO 639-1 code (en, es, de, ...)

{
  "keywords": [
    "python"
  ],
  "country": "worldwide",
  "timeframe": "today 12-m",
  "category": 0,
  "property": "web",
  "language": "en-US",
  "resolution": "country",
  "count": 100,
  "regions": [
    {
      "code": "CN",
      "name": "China",
      "values": {
        "python": 100
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "ER",
      "name": "Eritrea",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "AS",
      "name": "American Samoa",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "SG",
      "name": "Singapore",
      "values": {
        "python": 58
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "NP",
      "name": "Nepal",
      "values": {
        "python": 40
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "HK",
      "name": "Hong Kong",
      "values": {
        "python": 40
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "AI",
      "name": "Anguilla",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "KR",
      "name": "South Korea",
      "values": {
        "python": 39
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "BT",
      "name": "Bhutan",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "EH",
      "name": "Western Sahara",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "SJ",
      "name": "Svalbard & Jan Mayen",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "IN",
      "name": "India",
      "values": {
        "python": 35
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "ET",
      "name": "Ethiopia",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "MA",
      "name": "Morocco",
      "values": {
        "python": 32
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "US",
      "name": "United States",
      "values": {
        "python": 32
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "MO",
      "name": "Macao",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "IL",
      "name": "Israel",
      "values": {
        "python": 31
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "TN",
      "name": "Tunisia",
      "values": {
        "python": 30
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "XK",
      "name": "Kosovo",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "NL",
      "name": "Netherlands",
      "values": {
        "python": 29
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "AM",
      "name": "Armenia",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "TT",
      "name": "Trinidad & Tobago",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "CH",
      "name": "Switzerland",
      "values": {
        "python": 27
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "CA",
      "name": "Canada",
      "values": {
        "python": 27
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "LU",
      "name": "Luxembourg",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "OM",
      "name": "Oman",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "SH",
      "name": "St. Helena",
      "values": {
        "python": 27
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "PK",
      "name": "Pakistan",
      "values": {
        "python": 26
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "AL",
      "name": "Albania",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "MG",
      "name": "Madagascar",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "LI",
      "name": "Liechtenstein",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "EG",
      "name": "Egypt",
      "values": {
        "python": 25
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "AD",
      "name": "Andorra",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "RW",
      "name": "Rwanda",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "PS",
      "name": "Palestine",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "VN",
      "name": "Vietnam",
      "values": {
        "python": 24
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "AZ",
      "name": "Azerbaijan",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "UZ",
      "name": "Uzbekistan",
      "values": {
        "python": 23
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "IS",
      "name": "Iceland",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "RU",
      "name": "Russia",
      "values": {
        "python": 23
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "GB",
      "name": "United Kingdom",
      "values": {
        "python": 22
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "AE",
      "name": "United Arab Emirates",
      "values": {
        "python": 22
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "TG",
      "name": "Togo",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "FI",
      "name": "Finland",
      "values": {
        "python": 22
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "LV",
      "name": "Latvia",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "PT",
      "name": "Portugal",
      "values": {
        "python": 22
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "AU",
      "name": "Australia",
      "values": {
        "python": 22
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "JO",
      "name": "Jordan",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "EE",
      "name": "Estonia",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "MN",
      "name": "Mongolia",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "TW",
      "name": "Taiwan",
      "values": {
        "python": 22
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "NO",
      "name": "Norway",
      "values": {
        "python": 22
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "KE",
      "name": "Kenya",
      "values": {
        "python": 21
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "BD",
      "name": "Bangladesh",
      "values": {
        "python": 21
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "SE",
      "name": "Sweden",
      "values": {
        "python": 21
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "KI",
      "name": "Kiribati",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "LK",
      "name": "Sri Lanka",
      "values": {
        "python": 21
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "DE",
      "name": "Germany",
      "values": {
        "python": 21
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "EC",
      "name": "Ecuador",
      "values": {
        "python": 20
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "LT",
      "name": "Lithuania",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "MD",
      "name": "Moldova",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "DK",
      "name": "Denmark",
      "values": {
        "python": 20
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "KZ",
      "name": "Kazakhstan",
      "values": {
        "python": 20
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "KH",
      "name": "Cambodia",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "IE",
      "name": "Ireland",
      "values": {
        "python": 20
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "MT",
      "name": "Malta",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "CZ",
      "name": "Czechia",
      "values": {
        "python": 20
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "FR",
      "name": "France",
      "values": {
        "python": 20
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "BS",
      "name": "Bahamas",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "AT",
      "name": "Austria",
      "values": {
        "python": 19
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "SI",
      "name": "Slovenia",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "CY",
      "name": "Cyprus",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "GE",
      "name": "Georgia",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "MV",
      "name": "Maldives",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "LB",
      "name": "Lebanon",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "DZ",
      "name": "Algeria",
      "values": {
        "python": 19
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "KN",
      "name": "St. Kitts & Nevis",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "BE",
      "name": "Belgium",
      "values": {
        "python": 18
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "BH",
      "name": "Bahrain",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "BJ",
      "name": "Benin",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "CR",
      "name": "Costa Rica",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "MY",
      "name": "Malaysia",
      "values": {
        "python": 18
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "MK",
      "name": "North Macedonia",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "HU",
      "name": "Hungary",
      "values": {
        "python": 18
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "NZ",
      "name": "New Zealand",
      "values": {
        "python": 18
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "RS",
      "name": "Serbia",
      "values": {
        "python": 18
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "BG",
      "name": "Bulgaria",
      "values": {
        "python": 17
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "VI",
      "name": "U.S. Virgin Islands",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "IQ",
      "name": "Iraq",
      "values": {
        "python": 17
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "QA",
      "name": "Qatar",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "BB",
      "name": "Barbados",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "MF",
      "name": "St. Martin",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "PH",
      "name": "Philippines",
      "values": {
        "python": 17
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "BF",
      "name": "Burkina Faso",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "KY",
      "name": "Cayman Islands",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "CO",
      "name": "Colombia",
      "values": {
        "python": 17
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    },
    {
      "code": "ZW",
      "name": "Zimbabwe",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "MM",
      "name": "Myanmar (Burma)",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "BN",
      "name": "Brunei",
      "values": {
        "python": 0
      },
      "max_value_index": 0,
      "has_data": false,
      "coordinates": null
    },
    {
      "code": "PL",
      "name": "Poland",
      "values": {
        "python": 16
      },
      "max_value_index": 0,
      "has_data": true,
      "coordinates": null
    }
  ]
}