NAVNavbar
Logo
php python csharp java

Get Google Trends Explore Results by id

This endpoint will provide you with Google Trends data.

Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-dashboard

<?php
// You can download this file from here https://cdn.dataforseo.com/v3/examples/php/php_RestClient.zip
require('RestClient.php');
$api_url = 'https://api.dataforseo.com/';
try {
	// Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-dashboard
	$client = new RestClient($api_url, null, 'login', 'password');
} catch (RestClientException $e) {
	echo "\n";
	print "HTTP code: {$e->getHttpCode()}\n";
	print "Error code: {$e->getCode()}\n";
	print "Message: {$e->getMessage()}\n";
	print  $e->getTraceAsString();
	echo "\n";
	exit();
}
try {
	$result = array();
	// #1 - using this method you can get a list of completed tasks
	// GET /v3/keywords_data/google_trends/explore/tasks_ready
	$tasks_ready = $client->get('/v3/keywords_data/google_trends/explore/tasks_ready');
	// you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
	if (isset($tasks_ready['status_code']) AND $tasks_ready['status_code'] === 20000) {
		foreach ($tasks_ready['tasks'] as $task) {
			if (isset($task['result'])) {
				foreach ($task['result'] as $task_ready) {
					// #2 - using this method you can get results of each completed task
					// GET /v3/keywords_data/google_trends/explore/task_get/$id
					if (isset($task_ready['endpoint'])) {
						$result[] = $client->get($task_ready['endpoint']);
					}
					// #3 - another way to get the task results by id
					// GET /v3/keywords_data/google_trends/explore/task_get/$id
					/*
					if (isset($task_ready['id'])) {
						$result[] = $client->get('/v3/keywords_data/google_trends/explore/task_get/' . $task_ready['id']);
					}
					*/
				}
			}
		}
	}
	print_r($result);
	// do something with result
} catch (RestClientException $e) {
	echo "\n";
	print "HTTP code: {$e->getHttpCode()}\n";
	print "Error code: {$e->getCode()}\n";
	print "Message: {$e->getMessage()}\n";
	print  $e->getTraceAsString();
	echo "\n";
}
$client = null;
?>

The above command returns JSON structured like this:

{
  "version": "0.1.20200324",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1061 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "03251413-1535-0170-0000-9a6dca77f506",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0512 sec.",
      "cost": 0,
      "result_count": 1,
      "path": [
        "v3",
        "keywords_data",
        "google_trends",
        "explore",
        "task_get",
        "03251413-1535-0170-0000-9a6dca77f506"
      ],
      "data": {
        "api": "keywords_data",
        "function": "explore",
        "se": "google_trends",
        "location_name": "United States",
        "date_from": "2019-01-01",
        "date_to": "2020-01-01",
        "type": "youtube",
        "category_code": 3,
        "keywords": [
          "rugby",
          "cricket"
        ]
      },
      "result": [
        {
          "keywords": [
            "rugby",
            "cricket"
          ],
          "type": "trends",
          "location_code": 2840,
          "language_code": "en-US",
          "check_url": "https://trends.google.com/trends/explore?hl=en-US&cat=3&gprop=youtube&geo=US&date=today%2012-m&q=rugby%2Ccricket",
          "datetime": "2020-03-25 12:14:11 +00:00",
          "items_count": 6,
          "items": [
            {
              "position": 1,
              "type": "google_trends_graph",
              "title": "Interest over time",
              "keywords": [
                "rugby",
                "cricket"
              ],
              "data": [
                {
                  "date_from": "2019-03-31",
                  "date_to": "2019-04-06",
                  "timestamp": 1553990400,
                  "values": [
                    10,
                    60
                  ]
                },
                {
                  "date_from": "2019-04-07",
                  "date_to": "2019-04-13",
                  "timestamp": 1554595200,
                  "values": [
                    15,
                    58
                  ]
                },
                {
                  "date_from": "2019-04-14",
                  "date_to": "2019-04-20",
                  "timestamp": 1555200000,
                  "values": [
                    11,
                    55
                  ]
                },
                {
                  "date_from": "2019-04-21",
                  "date_to": "2019-04-27",
                  "timestamp": 1555804800,
                  "values": [
                    10,
                    55
                  ]
                },
                {
                  "date_from": "2019-04-28",
                  "date_to": "2019-05-04",
                  "timestamp": 1556409600,
                  "values": [
                    12,
                    53
                  ]
                },
                {
                  "date_from": "2019-05-05",
                  "date_to": "2019-05-11",
                  "timestamp": 1557014400,
                  "values": [
                    12,
                    52
                  ]
                },
                {
                  "date_from": "2019-05-12",
                  "date_to": "2019-05-18",
                  "timestamp": 1557619200,
                  "values": [
                    13,
                    65
                  ]
                },
                {
                  "date_from": "2019-05-19",
                  "date_to": "2019-05-25",
                  "timestamp": 1558224000,
                  "values": [
                    10,
                    70
                  ]
                },
                {
                  "date_from": "2019-05-26",
                  "date_to": "2019-06-01",
                  "timestamp": 1558828800,
                  "values": [
                    13,
                    85
                  ]
                },
                {
                  "date_from": "2019-06-02",
                  "date_to": "2019-06-08",
                  "timestamp": 1559433600,
                  "values": [
                    23,
                    90
                  ]
                },
                {
                  "date_from": "2019-06-09",
                  "date_to": "2019-06-15",
                  "timestamp": 1560038400,
                  "values": [
                    15,
                    76
                  ]
                },
                {
                  "date_from": "2019-06-16",
                  "date_to": "2019-06-22",
                  "timestamp": 1560643200,
                  "values": [
                    13,
                    97
                  ]
                },
                {
                  "date_from": "2019-06-23",
                  "date_to": "2019-06-29",
                  "timestamp": 1561248000,
                  "values": [
                    14,
                    100
                  ]
                },
                {
                  "date_from": "2019-06-30",
                  "date_to": "2019-07-06",
                  "timestamp": 1561852800,
                  "values": [
                    13,
                    93
                  ]
                },
                {
                  "date_from": "2019-07-07",
                  "date_to": "2019-07-13",
                  "timestamp": 1562457600,
                  "values": [
                    15,
                    90
                  ]
                },
                {
                  "date_from": "2019-07-14",
                  "date_to": "2019-07-20",
                  "timestamp": 1563062400,
                  "values": [
                    9,
                    82
                  ]
                },
                {
                  "date_from": "2019-07-21",
                  "date_to": "2019-07-27",
                  "timestamp": 1563667200,
                  "values": [
                    12,
                    65
                  ]
                },
                {
                  "date_from": "2019-07-28",
                  "date_to": "2019-08-03",
                  "timestamp": 1564272000,
                  "values": [
                    11,
                    73
                  ]
                },
                {
                  "date_from": "2019-08-04",
                  "date_to": "2019-08-10",
                  "timestamp": 1564876800,
                  "values": [
                    10,
                    69
                  ]
                },
                {
                  "date_from": "2019-08-11",
                  "date_to": "2019-08-17",
                  "timestamp": 1565481600,
                  "values": [
                    9,
                    70
                  ]
                },
                {
                  "date_from": "2019-08-18",
                  "date_to": "2019-08-24",
                  "timestamp": 1566086400,
                  "values": [
                    9,
                    38
                  ]
                },
                {
                  "date_from": "2019-08-25",
                  "date_to": "2019-08-31",
                  "timestamp": 1566691200,
                  "values": [
                    13,
                    64
                  ]
                },
                {
                  "date_from": "2019-09-01",
                  "date_to": "2019-09-07",
                  "timestamp": 1567296000,
                  "values": [
                    13,
                    62
                  ]
                },
                {
                  "date_from": "2019-09-08",
                  "date_to": "2019-09-14",
                  "timestamp": 1567900800,
                  "values": [
                    15,
                    59
                  ]
                },
                {
                  "date_from": "2019-09-15",
                  "date_to": "2019-09-21",
                  "timestamp": 1568505600,
                  "values": [
                    25,
                    41
                  ]
                },
                {
                  "date_from": "2019-09-22",
                  "date_to": "2019-09-28",
                  "timestamp": 1569110400,
                  "values": [
                    21,
                    54
                  ]
                },
                {
                  "date_from": "2019-09-29",
                  "date_to": "2019-10-05",
                  "timestamp": 1569715200,
                  "values": [
                    31,
                    64
                  ]
                },
                {
                  "date_from": "2019-10-06",
                  "date_to": "2019-10-12",
                  "timestamp": 1570320000,
                  "values": [
                    21,
                    55
                  ]
                },
                {
                  "date_from": "2019-10-13",
                  "date_to": "2019-10-19",
                  "timestamp": 1570924800,
                  "values": [
                    33,
                    42
                  ]
                },
                {
                  "date_from": "2019-10-20",
                  "date_to": "2019-10-26",
                  "timestamp": 1571529600,
                  "values": [
                    30,
                    66
                  ]
                },
                {
                  "date_from": "2019-10-27",
                  "date_to": "2019-11-02",
                  "timestamp": 1572134400,
                  "values": [
                    18,
                    46
                  ]
                },
                {
                  "date_from": "2019-11-03",
                  "date_to": "2019-11-09",
                  "timestamp": 1572739200,
                  "values": [
                    22,
                    52
                  ]
                },
                {
                  "date_from": "2019-11-10",
                  "date_to": "2019-11-16",
                  "timestamp": 1573344000,
                  "values": [
                    16,
                    65
                  ]
                },
                {
                  "date_from": "2019-11-17",
                  "date_to": "2019-11-23",
                  "timestamp": 1573948800,
                  "values": [
                    18,
                    50
                  ]
                },
                {
                  "date_from": "2019-11-24",
                  "date_to": "2019-11-30",
                  "timestamp": 1574553600,
                  "values": [
                    19,
                    61
                  ]
                },
                {
                  "date_from": "2019-12-01",
                  "date_to": "2019-12-07",
                  "timestamp": 1575158400,
                  "values": [
                    9,
                    73
                  ]
                },
                {
                  "date_from": "2019-12-08",
                  "date_to": "2019-12-14",
                  "timestamp": 1575763200,
                  "values": [
                    15,
                    73
                  ]
                },
                {
                  "date_from": "2019-12-15",
                  "date_to": "2019-12-21",
                  "timestamp": 1576368000,
                  "values": [
                    9,
                    57
                  ]
                },
                {
                  "date_from": "2019-12-22",
                  "date_to": "2019-12-28",
                  "timestamp": 1576972800,
                  "values": [
                    11,
                    44
                  ]
                },
                {
                  "date_from": "2019-12-29",
                  "date_to": "2020-01-04",
                  "timestamp": 1577577600,
                  "values": [
                    13,
                    60
                  ]
                },
                {
                  "date_from": "2020-01-05",
                  "date_to": "2020-01-11",
                  "timestamp": 1578182400,
                  "values": [
                    11,
                    58
                  ]
                },
                {
                  "date_from": "2020-01-12",
                  "date_to": "2020-01-18",
                  "timestamp": 1578787200,
                  "values": [
                    16,
                    38
                  ]
                },
                {
                  "date_from": "2020-01-19",
                  "date_to": "2020-01-25",
                  "timestamp": 1579392000,
                  "values": [
                    5,
                    74
                  ]
                },
                {
                  "date_from": "2020-01-26",
                  "date_to": "2020-02-01",
                  "timestamp": 1579996800,
                  "values": [
                    21,
                    48
                  ]
                },
                {
                  "date_from": "2020-02-02",
                  "date_to": "2020-02-08",
                  "timestamp": 1580601600,
                  "values": [
                    25,
                    57
                  ]
                },
                {
                  "date_from": "2020-02-09",
                  "date_to": "2020-02-15",
                  "timestamp": 1581206400,
                  "values": [
                    18,
                    58
                  ]
                },
                {
                  "date_from": "2020-02-16",
                  "date_to": "2020-02-22",
                  "timestamp": 1581811200,
                  "values": [
                    29,
                    43
                  ]
                },
                {
                  "date_from": "2020-02-23",
                  "date_to": "2020-02-29",
                  "timestamp": 1582416000,
                  "values": [
                    16,
                    43
                  ]
                },
                {
                  "date_from": "2020-03-01",
                  "date_to": "2020-03-07",
                  "timestamp": 1583020800,
                  "values": [
                    14,
                    59
                  ]
                },
                {
                  "date_from": "2020-03-08",
                  "date_to": "2020-03-14",
                  "timestamp": 1583625600,
                  "values": [
                    14,
                    64
                  ]
                },
                {
                  "date_from": "2020-03-15",
                  "date_to": "2020-03-21",
                  "timestamp": 1584230400,
                  "values": [
                    14,
                    61
                  ]
                },
                {
                  "date_from": "2020-03-22",
                  "date_to": null,
                  "timestamp": 1584835200,
                  "values": [
                    null,
                    97
                  ]
                }
              ],
              "averages": [
                15,
                63
              ]
            },
            {
              "position": 2,
              "type": "google_trends_map",
              "title": "Compared breakdown by subregion",
              "keywords": [
                "rugby",
                "cricket"
              ],
              "data": [
                {
                  "geo_id": "US-WY",
                  "geo_name": "Wyoming",
                  "values": [
                    66,
                    34
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-MT",
                  "geo_name": "Montana",
                  "values": [
                    null,
                    100
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-VT",
                  "geo_name": "Vermont",
                  "values": [
                    49,
                    51
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-AK",
                  "geo_name": "Alaska",
                  "values": [
                    32,
                    68
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-ND",
                  "geo_name": "North Dakota",
                  "values": [
                    null,
                    100
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-DE",
                  "geo_name": "Delaware",
                  "values": [
                    null,
                    100
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-VA",
                  "geo_name": "Virginia",
                  "values": [
                    11,
                    89
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-KY",
                  "geo_name": "Kentucky",
                  "values": [
                    18,
                    82
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-NJ",
                  "geo_name": "New Jersey",
                  "values": [
                    13,
                    87
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-SD",
                  "geo_name": "South Dakota",
                  "values": [
                    32,
                    68
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-CT",
                  "geo_name": "Connecticut",
                  "values": [
                    21,
                    79
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-ID",
                  "geo_name": "Idaho",
                  "values": [
                    20,
                    80
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-ME",
                  "geo_name": "Maine",
                  "values": [
                    24,
                    76
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-SC",
                  "geo_name": "South Carolina",
                  "values": [
                    15,
                    85
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-NY",
                  "geo_name": "New York",
                  "values": [
                    13,
                    87
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-GA",
                  "geo_name": "Georgia",
                  "values": [
                    9,
                    91
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-NC",
                  "geo_name": "North Carolina",
                  "values": [
                    15,
                    85
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-MS",
                  "geo_name": "Mississippi",
                  "values": [
                    null,
                    100
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-MA",
                  "geo_name": "Massachusetts",
                  "values": [
                    19,
                    81
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-TN",
                  "geo_name": "Tennessee",
                  "values": [
                    9,
                    91
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-MD",
                  "geo_name": "Maryland",
                  "values": [
                    20,
                    80
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-HI",
                  "geo_name": "Hawaii",
                  "values": [
                    36,
                    64
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-NV",
                  "geo_name": "Nevada",
                  "values": [
                    8,
                    92
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-LA",
                  "geo_name": "Louisiana",
                  "values": [
                    18,
                    82
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-OH",
                  "geo_name": "Ohio",
                  "values": [
                    16,
                    84
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-CA",
                  "geo_name": "California",
                  "values": [
                    20,
                    80
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-AL",
                  "geo_name": "Alabama",
                  "values": [
                    15,
                    85
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-WI",
                  "geo_name": "Wisconsin",
                  "values": [
                    22,
                    78
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-TX",
                  "geo_name": "Texas",
                  "values": [
                    17,
                    83
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-IL",
                  "geo_name": "Illinois",
                  "values": [
                    20,
                    80
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-MO",
                  "geo_name": "Missouri",
                  "values": [
                    11,
                    89
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-MI",
                  "geo_name": "Michigan",
                  "values": [
                    14,
                    86
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-IN",
                  "geo_name": "Indiana",
                  "values": [
                    17,
                    83
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-UT",
                  "geo_name": "Utah",
                  "values": [
                    31,
                    69
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-DC",
                  "geo_name": "District of Columbia",
                  "values": [
                    59,
                    41
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-PA",
                  "geo_name": "Pennsylvania",
                  "values": [
                    18,
                    82
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-IA",
                  "geo_name": "Iowa",
                  "values": [
                    35,
                    65
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-OR",
                  "geo_name": "Oregon",
                  "values": [
                    34,
                    66
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-NE",
                  "geo_name": "Nebraska",
                  "values": [
                    null,
                    100
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-FL",
                  "geo_name": "Florida",
                  "values": [
                    16,
                    84
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-NM",
                  "geo_name": "New Mexico",
                  "values": [
                    22,
                    78
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-CO",
                  "geo_name": "Colorado",
                  "values": [
                    23,
                    77
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-AR",
                  "geo_name": "Arkansas",
                  "values": [
                    30,
                    70
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-WA",
                  "geo_name": "Washington",
                  "values": [
                    31,
                    69
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-NH",
                  "geo_name": "New Hampshire",
                  "values": [
                    32,
                    68
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-OK",
                  "geo_name": "Oklahoma",
                  "values": [
                    22,
                    78
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-MN",
                  "geo_name": "Minnesota",
                  "values": [
                    25,
                    75
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-AZ",
                  "geo_name": "Arizona",
                  "values": [
                    24,
                    76
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-WV",
                  "geo_name": "West Virginia",
                  "values": [
                    36,
                    64
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-KS",
                  "geo_name": "Kansas",
                  "values": [
                    28,
                    72
                  ],
                  "max_value_index": 1
                },
                {
                  "geo_id": "US-RI",
                  "geo_name": "Rhode Island",
                  "values": [
                    42,
                    58
                  ],
                  "max_value_index": 1
                }
              ]
            },
            {
              "position": 3,
              "type": "google_trends_map",
              "title": "Interest by subregion",
              "keywords": [
                "rugby"
              ],
              "data": [
                {
                  "geo_id": "US-WY",
                  "geo_name": "Wyoming",
                  "values": [
                    100
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-VT",
                  "geo_name": "Vermont",
                  "values": [
                    73
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-DC",
                  "geo_name": "District of Columbia",
                  "values": [
                    38
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-AK",
                  "geo_name": "Alaska",
                  "values": [
                    34
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-SD",
                  "geo_name": "South Dakota",
                  "values": [
                    28
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-HI",
                  "geo_name": "Hawaii",
                  "values": [
                    24
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-IA",
                  "geo_name": "Iowa",
                  "values": [
                    21
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-OR",
                  "geo_name": "Oregon",
                  "values": [
                    19
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-UT",
                  "geo_name": "Utah",
                  "values": [
                    17
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-ME",
                  "geo_name": "Maine",
                  "values": [
                    17
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-NH",
                  "geo_name": "New Hampshire",
                  "values": [
                    16
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-CT",
                  "geo_name": "Connecticut",
                  "values": [
                    15
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-WA",
                  "geo_name": "Washington",
                  "values": [
                    15
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-AR",
                  "geo_name": "Arkansas",
                  "values": [
                    15
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-WV",
                  "geo_name": "West Virginia",
                  "values": [
                    15
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-ID",
                  "geo_name": "Idaho",
                  "values": [
                    15
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-KY",
                  "geo_name": "Kentucky",
                  "values": [
                    13
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-RI",
                  "geo_name": "Rhode Island",
                  "values": [
                    13
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-WI",
                  "geo_name": "Wisconsin",
                  "values": [
                    11
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-MA",
                  "geo_name": "Massachusetts",
                  "values": [
                    11
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-CO",
                  "geo_name": "Colorado",
                  "values": [
                    11
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-CA",
                  "geo_name": "California",
                  "values": [
                    11
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-MD",
                  "geo_name": "Maryland",
                  "values": [
                    10
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-IL",
                  "geo_name": "Illinois",
                  "values": [
                    10
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-NM",
                  "geo_name": "New Mexico",
                  "values": [
                    10
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-LA",
                  "geo_name": "Louisiana",
                  "values": [
                    9
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-SC",
                  "geo_name": "South Carolina",
                  "values": [
                    9
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-MN",
                  "geo_name": "Minnesota",
                  "values": [
                    9
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-NJ",
                  "geo_name": "New Jersey",
                  "values": [
                    9
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-PA",
                  "geo_name": "Pennsylvania",
                  "values": [
                    9
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-NC",
                  "geo_name": "North Carolina",
                  "values": [
                    8
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-AZ",
                  "geo_name": "Arizona",
                  "values": [
                    8
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-TX",
                  "geo_name": "Texas",
                  "values": [
                    8
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-NY",
                  "geo_name": "New York",
                  "values": [
                    8
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-OK",
                  "geo_name": "Oklahoma",
                  "values": [
                    8
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-OH",
                  "geo_name": "Ohio",
                  "values": [
                    8
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-VA",
                  "geo_name": "Virginia",
                  "values": [
                    8
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-IN",
                  "geo_name": "Indiana",
                  "values": [
                    8
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-KS",
                  "geo_name": "Kansas",
                  "values": [
                    8
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-AL",
                  "geo_name": "Alabama",
                  "values": [
                    8
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-FL",
                  "geo_name": "Florida",
                  "values": [
                    7
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-MI",
                  "geo_name": "Michigan",
                  "values": [
                    6
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-MO",
                  "geo_name": "Missouri",
                  "values": [
                    5
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-GA",
                  "geo_name": "Georgia",
                  "values": [
                    5
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-TN",
                  "geo_name": "Tennessee",
                  "values": [
                    4
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-NV",
                  "geo_name": "Nevada",
                  "values": [
                    4
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-DE",
                  "geo_name": "Delaware",
                  "values": [
                    null
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-MS",
                  "geo_name": "Mississippi",
                  "values": [
                    null
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-MT",
                  "geo_name": "Montana",
                  "values": [
                    null
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-ND",
                  "geo_name": "North Dakota",
                  "values": [
                    null
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-NE",
                  "geo_name": "Nebraska",
                  "values": [
                    null
                  ],
                  "max_value_index": 0
                }
              ]
            },
            {
              "position": 4,
              "type": "google_trends_queries_list",
              "title": "Related queries",
              "keywords": [
                "rugby"
              ],
              "data": {
                "top": [
                  {
                    "query": "how to play rugby",
                    "value": 100
                  },
                  {
                    "query": "super rugby 2020",
                    "value": 100
                  },
                  {
                    "query": "rugby hits",
                    "value": 57
                  }
                ],
                "rising": [
                  {
                    "query": "super rugby 2020",
                    "value": 144100
                  }
                ]
              }
            },
            {
              "position": 5,
              "type": "google_trends_map",
              "title": "Interest by subregion",
              "keywords": [
                "cricket"
              ],
              "data": [
                {
                  "geo_id": "US-AK",
                  "geo_name": "Alaska",
                  "values": [
                    100
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-MT",
                  "geo_name": "Montana",
                  "values": [
                    76
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-DC",
                  "geo_name": "District of Columbia",
                  "values": [
                    76
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-ID",
                  "geo_name": "Idaho",
                  "values": [
                    68
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-ND",
                  "geo_name": "North Dakota",
                  "values": [
                    66
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-CT",
                  "geo_name": "Connecticut",
                  "values": [
                    62
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-VA",
                  "geo_name": "Virginia",
                  "values": [
                    62
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-KY",
                  "geo_name": "Kentucky",
                  "values": [
                    59
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-NJ",
                  "geo_name": "New Jersey",
                  "values": [
                    56
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-GA",
                  "geo_name": "Georgia",
                  "values": [
                    50
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-WY",
                  "geo_name": "Wyoming",
                  "values": [
                    50
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-NV",
                  "geo_name": "Nevada",
                  "values": [
                    49
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-NY",
                  "geo_name": "New York",
                  "values": [
                    49
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-SD",
                  "geo_name": "South Dakota",
                  "values": [
                    46
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-SC",
                  "geo_name": "South Carolina",
                  "values": [
                    45
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-LA",
                  "geo_name": "Louisiana",
                  "values": [
                    44
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-MA",
                  "geo_name": "Massachusetts",
                  "values": [
                    44
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-NC",
                  "geo_name": "North Carolina",
                  "values": [
                    44
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-CO",
                  "geo_name": "Colorado",
                  "values": [
                    43
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-TN",
                  "geo_name": "Tennessee",
                  "values": [
                    43
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-AL",
                  "geo_name": "Alabama",
                  "values": [
                    42
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-MS",
                  "geo_name": "Mississippi",
                  "values": [
                    42
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-ME",
                  "geo_name": "Maine",
                  "values": [
                    41
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-OH",
                  "geo_name": "Ohio",
                  "values": [
                    41
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-DE",
                  "geo_name": "Delaware",
                  "values": [
                    40
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-MD",
                  "geo_name": "Maryland",
                  "values": [
                    40
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-CA",
                  "geo_name": "California",
                  "values": [
                    40
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-HI",
                  "geo_name": "Hawaii",
                  "values": [
                    40
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-TX",
                  "geo_name": "Texas",
                  "values": [
                    39
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-MO",
                  "geo_name": "Missouri",
                  "values": [
                    39
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-OR",
                  "geo_name": "Oregon",
                  "values": [
                    39
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-IL",
                  "geo_name": "Illinois",
                  "values": [
                    38
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-IN",
                  "geo_name": "Indiana",
                  "values": [
                    37
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-MI",
                  "geo_name": "Michigan",
                  "values": [
                    37
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-WI",
                  "geo_name": "Wisconsin",
                  "values": [
                    36
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-VT",
                  "geo_name": "Vermont",
                  "values": [
                    36
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-PA",
                  "geo_name": "Pennsylvania",
                  "values": [
                    35
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-FL",
                  "geo_name": "Florida",
                  "values": [
                    35
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-UT",
                  "geo_name": "Utah",
                  "values": [
                    35
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-IA",
                  "geo_name": "Iowa",
                  "values": [
                    31
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-NM",
                  "geo_name": "New Mexico",
                  "values": [
                    30
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-WV",
                  "geo_name": "West Virginia",
                  "values": [
                    29
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-NE",
                  "geo_name": "Nebraska",
                  "values": [
                    29
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-AR",
                  "geo_name": "Arkansas",
                  "values": [
                    29
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-MN",
                  "geo_name": "Minnesota",
                  "values": [
                    29
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-WA",
                  "geo_name": "Washington",
                  "values": [
                    28
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-OK",
                  "geo_name": "Oklahoma",
                  "values": [
                    25
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-AZ",
                  "geo_name": "Arizona",
                  "values": [
                    25
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-NH",
                  "geo_name": "New Hampshire",
                  "values": [
                    21
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-KS",
                  "geo_name": "Kansas",
                  "values": [
                    20
                  ],
                  "max_value_index": 0
                },
                {
                  "geo_id": "US-RI",
                  "geo_name": "Rhode Island",
                  "values": [
                    17
                  ],
                  "max_value_index": 0
                }
              ]
            },
            {
              "position": 6,
              "type": "google_trends_queries_list",
              "title": "Related queries",
              "keywords": [
                "cricket"
              ],
              "data": {
                "top": [
                  {
                    "query": "jiminy cricket",
                    "value": 100
                  },
                  {
                    "query": "cricket live",
                    "value": 90
                  },
                  {
                    "query": "cricket sounds",
                    "value": 87
                  },
                  {
                    "query": "colt ford",
                    "value": 56
                  },
                  {
                    "query": "cricket on a line colt ford lyrics",
                    "value": 49
                  },
                  {
                    "query": "cricket sound",
                    "value": 48
                  },
                  {
                    "query": "mud cricket",
                    "value": 40
                  },
                  {
                    "query": "cricket sound effect",
                    "value": 35
                  },
                  {
                    "query": "colt ford cricket on the line",
                    "value": 28
                  },
                  {
                    "query": "cricket world cup 2019",
                    "value": 20
                  },
                  {
                    "query": "funny cricket moments",
                    "value": 20
                  },
                  {
                    "query": "cricket noise",
                    "value": 19
                  },
                  {
                    "query": "cricket sounds for sleeping",
                    "value": 17
                  },
                  {
                    "query": "noisy cricket",
                    "value": 15
                  },
                  {
                    "query": "jiminy cricket when you wish upon a star",
                    "value": 14
                  },
                  {
                    "query": "live cricket match today",
                    "value": 13
                  },
                  {
                    "query": "big city greens",
                    "value": 13
                  },
                  {
                    "query": "cricket highlights",
                    "value": 11
                  },
                  {
                    "query": "world cup cricket live",
                    "value": 11
                  },
                  {
                    "query": "cricket noise sound effect",
                    "value": 7
                  },
                  {
                    "query": "bd cricket news",
                    "value": 4
                  }
                ],
                "rising": [
                  {
                    "query": "world cup cricket live",
                    "value": 350
                  },
                  {
                    "query": "cricket world cup 2019",
                    "value": 350
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  ]
}

Description of the fields for sending a request:

Field name Type Description
id string task identifier
unique task identifier in our system in the UUID format
you will be able to use it within 30 days to request the results of the task at any time


As a response of the API server, you will receive JSON-encoded data containing a tasks array with the information specific to the set tasks.

Description of the fields in the results array:

Field name Type Description
version string the current version of the API
status_code integer general status code
you can find the full list of the response codes here
status_message string general informational message
you can find the full list of general informational messages here
time string execution time, seconds
cost float total tasks cost, USD
tasks_count integer the number of tasks in the tasks array
tasks_error integer the number of tasks in the tasks array returned with an error
tasks array array of tasks
        id string task identifier
unique task identifier in our system in the UUID format
        status_code integer status code of the task
generated by DataForSEO; can be within the following range: 10000-60000
you can find the full list of response codes here
        status_message string informational message of the task
you can find the full list of general informational messages here
        time string execution time, seconds
        cost float cost of the task, USD
        result_count integer number of elements in the result array
        path array URL path
        data array contains the same parameters that you specified in the POST request
        result array array of results
            keywords array keywords you set in a POST array
keyword is returned with decoded %## (plus symbol ‘+’ will be decoded to a space character)
            location_code integer location code in a POST array
if there is no data, then the value is null
            language_code string language code in a POST array
if there is no data, then the value is null
            check_url float direct URL to the Google Trends results
you can use it to make sure that we provided accurate results
            datetime string date and time when the result was received
in the format: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”
example:
2019-11-15 12:57:46 +00:00
            items_count integer the number of results returned in the items array
            items array items on the Google Trends page
            ‘google_trends_graph’ element in Google Trends
                position integer the alignment of the element in Google Trends
can take the following values: 1, 2, 3, 4, etc.
                type string type of element = ‘google_trends_graph’
                title string title of the element in Google Trends
                keywords array relevant keywords
the data included in the google_trends_graph element is based on the keywords listed in this array
                data array Google Trends data for the specified parameters
                    date_from string start date of the corresponding time range
                    date_to string end date of the corresponding time range
                    timestamp integer a point in time in the Unix time format
                    values integer relative keyword popularity rate at a specific timestamp
represents the keyword popularity rate over the given time range
if you specify more than one keyword, the values will be averaged to the highest value across all specified keywords
a value of 100 is the peak popularity for the term. A value of 50 means that the term is half as popular. A score of 0 means there was not enough data for this term
                averages array keyword popularity value averaged over the whole time range
            ‘google_trends_map’ element in Google Trends
                position integer the alignment of the element in Google Trends
can take the following values: 1, 2, 3, 4, etc.
                type string type of element = ‘google_trends_map’
                title string title of the element in Google Trends
                keywords array relevant keywords
the data included in the google_trends_map element is based on the keywords listed in this array
                data array Google Trends data from the corresponding item
                    geo_id string Google Trends location identifier
you can use this field for matching obtained results with location parameters specified in the request
example:
US-NY
                    geo_name string Google Trends location name
you can use this field for matching obtained results with location parameters specified in the request
                    values integer relative keyword popularity rate in a given location
represents the location-specific keyword popularity rate over the given time range
if you specify more than one keyword, the values will be averaged to the highest value across all specified keywords
a value of 100 is the peak popularity for the term
a value of 50 means that the term is half as popular
a value of 0 means there was not enough data for this term
                    max_value_index integer max value among comparable terms
represents the maximum value if you specified more than two keywords in a POST array
if you specified only one keyword, the value will be null
            ‘google_trends_topics_list’ element in Google Trends
                position integer the alignment of the element in Google Trends
can take the following values: 1, 2, 3, 4, etc.
                type string type of element = ‘google_trends_topics_list’
                title string title of the element in Google Trends
                keywords array relevant keywords
the data included in the google_trends_topics_list element is based on the keywords listed in this array
                data array Google Trends data from the corresponding item
                    top array the most popular related topics
represents the list of the most popular related topics
                        topic_id string unique topic identifier in Google Trends
                        topic_title string title of the topic
                        topic_type string type of the topic
represents the general type of the topic
                        value string search term popularity
represents the popularity of the topic. Scoring is on a relative scale where a value of 100 is the most commonly searched topic and a value of 50 is a topic searched half as often as the most popular term, and so on.
                    rising array emerging related topics
represents the list of related topics with the biggest increase in search frequency since the last time period
                        topic_id string unique topic identifier in Google Trends
                        topic_title string title of the topic
                       topic_type string type of the topic
represents the general type of the topic
                       value string increase in the search term popularity
indicates the relative increase in the search term popularity within the given timeframe
the value is provided in percentage (without the % sign)
            ‘google_trends_queries_list’ element in Google Trends
                position integer the alignment of the element in Google Trends
can take the following values: 1, 2, 3, 4, etc.
                type string type of element = ‘google_trends_queries_list’
                title string title of the element in Google Trends
                keywords array relevant keywords
the data included in the google_trends_queries_list element is based on the keywords listed in this array
                data array Google Trends data from the corresponding item
                    top array the most popular related topics
represents the list of the most popular related topics
                        query string related query
                        value string search term popularity
represents the popularity of the topic. Scoring is on a relative scale where a value of 100 is the most commonly searched topic and a value of 50 is a topic searched half as often as the most popular term, and so on.
                    rising array emerging related topics
represents the list of related topics with the biggest increase in search frequency since the last time period
                        query string related query
                        value string search term popularity
represents the popularity of the topic. Scoring is on a relative scale where a value of 100 is the most commonly searched topic and a value of 50 is a topic searched half as often as the most popular term, and so on.

‌‌