DataForSEO — Keywords Data / Dataforseo Trends / Merged Data / Live

Retrieve keywords Data Dataforseo Trends Merged Data Live via API. The sample response includes keywords. Use it for search visibility research or technical SEO.

Selected price
$0.006 / callPublished pricing
Sellers / implementations
1 / 1
Requests · 30d
—Loading...
Success rate · 30d
—Loading...

Run sends a real API request. Charges follow the published API contract.

Request parameters
body* array
body[0]* object | null
keywords* array
keywords required field the maximum number of keywords you can specify: 5 avoid symbols and special characters (e.g., UTF symbols, emojis); specifying non-Latin characters, you’ll get data for the countries where they are used learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article
Optional parameters (7)
starting date of the time range optional field if you don't specify this field, the current day and month of the preceding year will be used by default minimal value for the web type: 2004-01-01 minimal value for other types: 2008-01-01 date format: "yyyy-mm-dd" example: "2019-01-15"
ending date of the time range optional field if you don't specify this field, the today's date will be used by default date format: "yyyy-mm-dd" example: "2019-01-15"
search engine location code optional field if you don't use this field, you will recieve global results if you use this field, you don't need to specify location_name you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations note that the data will be provided for the country the specified location_code belongs to; example: 2840
full name of search engine location optional field if you don't use this field, you will recieve global results if you use this field, you don't need to specify location_code you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations note that the data will be provided for the country the specified location_name belongs to; example: United Kingdom
user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response
preset time ranges optional field if you specify date_from or date_to parameters, this field will be ignored when setting a task possible values for all type parameters: past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years
dataforseo trends type optional field if you don't specify this field, the web type will be used by default possible values: web, news, ecommerce
This endpoint will provide you with the keyword popularity data from DataForSEO Trends. In addition to keyword popularity rate over the given time range, you will get location-specific keyword popularity data, and a demographic breakdown of keyword popularity per each specified term along with comparative values.

Sample response

{
  "cost": 0.005,
  "status_code": 20000,
  "status_message": "Ok.",
  "tasks": [
    {
      "cost": 0.005,
      "data": {
        "api": "keywords_data",
        "date_from": "2023-01-01",
        "date_to": "2024-01-01",
        "function": "merged_data",
        "keywords": [
          "rugby",
          "cricket"
        ],
        "location_name": "United States",
        "se": "dataforseo_trends",
        "type": "web"
      },
      "id": "03121401-1535-0575-0000-972fd45034ab",
      "path": [
        "v3",
        "keywords_data",
        "dataforseo_trends",
        "merged_data",
        "live"
      ],
      "result": [
        {
          "datetime": "2024-03-12 12:01:58 +00:00",
          "items": [
            {
              "averages": [
                10,
                39
              ],
              "data": [
                {
                  "date_from": "2023-01-01",
                  "date_to": "2023-01-07",
                  "timestamp": 1672531200,
                  "values": [
                    4,
                    28
                  ]
                },
                {
                  "date_from": "2023-01-08",
                  "date_to": "2023-01-14",
                  "timestamp": 1673136000,
                  "values": [
                    7,
                    32
                  ]
                },
                {
                  "date_from": "2023-01-15",
                  "date_to": "2023-01-21",
                  "timestamp": 1673740800,
                  "values": [
                    6,
                    27
                  ]
                },
                {
                  "date_from": "2023-01-22",
                  "date_to": "2023-01-28",
                  "timestamp": 1674345600,
                  "values": [
                    7,
                    36
                  ]
                },
                {
                  "date_from": "2023-01-29",
                  "date_to": "2023-02-04",
                  "timestamp": 1674950400,
                  "values": [
                    7,
                    22
                  ]
                },
                {
                  "date_from": "2023-02-05",
                  "date_to": "2023-02-11",
                  "timestamp": 1675555200,
                  "values": [
                    8,
                    31
                  ]
                },
                {
                  "date_from": "2023-02-12",
                  "date_to": "2023-02-18",
                  "timestamp": 1676160000,
                  "values": [
                    7,
                    25
                  ]
                },
                {
                  "date_from": "2023-02-19",
                  "date_to": "2023-02-25",
                  "timestamp": 1676764800,
                  "values": [
                    10,
                    28
                  ]
                },
                {
                  "date_from": "2023-02-26",
                  "date_to": "2023-03-04",
                  "timestamp": 1677369600,
                  "values": [
                    7,
                    30
                  ]
                },
                {
                  "date_from": "2023-03-05",
                  "date_to": "2023-03-11",
                  "timestamp": 1677974400,
                  "values": [
                    9,
                    31
                  ]
                },
                {
                  "date_from": "2023-03-12",
                  "date_to": "2023-03-18",
                  "timestamp": 1678579200,
                  "values": [
                    10,
                    31
                  ]
                },
                {
                  "date_from": "2023-03-19",
                  "date_to": "2023-03-25",
                  "timestamp": 1679184000,
                  "values": [
                    6,
                    34
                  ]
                },
                {
                  "date_from": "2023-03-26",
                  "date_to": "2023-04-01",
                  "timestamp": 1679788800,
                  "values": [
                    9,
                    25
                  ]
                },
                {
                  "date_from": "2023-04-02",
                  "date_to": "2023-04-08",
                  "timestamp": 1680393600,
                  "values": [
                    7,
                    32
                  ]
                },
                {
                  "date_from": "2023-04-09",
                  "date_to": "2023-04-15",
                  "timestamp": 1680998400,
                  "values": [
                    8,
                    26
                  ]
                },
                {
                  "date_from": "2023-04-16",
                  "date_to": "2023-04-22",
                  "timestamp": 1681603200,
                  "values": [
                    7,
                    30
                  ]
                },
                {
                  "date_from": "2023-04-23",
                  "date_to": "2023-04-29",
                  "timestamp": 1682208000,
                  "values": [
                    6,
                    35
                  ]
                },
                {
                  "date_from": "2023-04-30",
                  "date_to": "2023-05-06",
                  "timestamp": 1682812800,
                  "values": [
                    7,
                    32
                  ]
                },
                {
                  "date_from": "2023-05-07",
                  "date_to": "2023-05-13",
                  "timestamp": 1683417600,
                  "values": [
                    8,
                    29
                  ]
                },
                {
                  "date_from": "2023-05-14",
                  "date_to": "2023-05-20",
                  "timestamp": 1684022400,
                  "values": [
                    7,
                    25
                  ]
                },
                {
                  "date_from": "2023-05-21",
                  "date_to": "2023-05-27",
                  "timestamp": 1684627200,
                  "values": [
                    5,
                    23
                  ]
                },
                {
                  "date_from": "2023-05-28",
                  "date_to": "2023-06-03",
                  "timestamp": 1685232000,
                  "values": [
                    9,
                    29
                  ]
                },
                {
                  "date_from": "2023-06-04",
                  "date_to": "2023-06-10",
                  "timestamp": 1685836800,
                  "values": [
                    8,
                    37
                  ]
                },
                {
                  "date_from": "2023-06-11",
                  "date_to": "2023-06-17",
                  "timestamp": 1686441600,
                  "values": [
                    7,
                    31
                  ]
                },
                {
                  "date_from": "2023-06-18",
                  "date_to": "2023-06-24",
                  "timestamp": 1687046400,
                  "values": [
                    8,
                    36
                  ]
                },
                {
                  "date_from": "2023-06-25",
                  "date_to": "2023-07-01",
                  "timestamp": 1687651200,
                  "values": [
                    8,
                    31
                  ]
                },
                {
                  "date_from": "2023-07-02",
                  "date_to": "2023-07-08",
                  "timestamp": 1688256000,
                  "values": [
                    5,
                    29
                  ]
                },
                {
                  "date_from": "2023-07-09",
                  "date_to": "2023-07-15",
                  "timestamp": 1688860800,
                  "values": [
                    4,
                    35
                  ]
                },
                {
                  "date_from": "2023-07-16",
                  "date_to": "2023-07-22",
                  "timestamp": 1689465600,
                  "values": [
                    7,
                    31
                  ]
                },
                {
                  "date_from": "2023-07-23",
                  "date_to": "2023-07-29",
                  "timestamp": 1690070400,
                  "values": [
                    6,
                    27
                  ]
                },
                {
                  "date_from": "2023-07-30",
                  "date_to": "2023-08-05",
                  "timestamp": 1690675200,
                  "values": [
                    11,
                    29
                  ]
                },
                {
                  "date_from": "2023-08-06",
                  "date_to": "2023-08-12",
                  "timestamp": 1691280000,
                  "values": [
                    9,
                    26
                  ]
                },
                {
                  "date_from": "2023-08-13",
                  "date_to": "2023-08-19",
                  "timestamp": 1691884800,
                  "values": [
                    8,
                    24
                  ]
                },
                {
                  "date_from": "2023-08-20",
                  "date_to": "2023-08-26",
                  "timestamp": 1692489600,
                  "values": [
                    8,
                    31
                  ]
                },
                {
                  "date_from": "2023-08-27",
                  "date_to": "2023-09-02",
                  "timestamp": 1693094400,
                  "values": [
                    10,
                    48
                  ]
                },
                {
                  "date_from": "2023-09-03",
                  "date_to": "2023-09-09",
                  "timestamp": 1693699200,
                  "values": [
                    21,
                    44
                  ]
                },
                {
                  "date_from": "2023-09-10",
                  "date_to": "2023-09-16",
                  "timestamp": 1694304000,
                  "values": [
                    23,
                    58
                  ]
                },
                {
                  "date_from": "2023-09-17",
                  "date_to": "2023-09-23",
                  "timestamp": 1694908800,
                  "values": [
                    22,
                    45
                  ]
                },
                {
                  "date_from": "2023-09-24",
                  "date_to": "2023-09-30",
                  "timestamp": 1695513600,
                  "values": [
                    22,
                    48
                  ]
                },
                {
                  "date_from": "2023-10-01",
                  "date_to": "2023-10-07",
                  "timestamp": 1696118400,
                  "values": [
                    18,
                    67
                  ]
                },
                {
                  "date_from": "2023-10-08",
                  "date_to": "2023-10-14",
                  "timestamp": 1696723200,
                  "values": [
                    23,
                    100
                  ]
                },
                {
                  "date_from": "2023-10-15",
                  "date_to": "2023-10-21",
                  "timestamp": 1697328000,
                  "values": [
                    32,
                    80
                  ]
                },
                {
                  "date_from": "2023-10-22",
                  "date_to": "2023-10-28",
                  "timestamp": 1697932800,
                  "values": [
                    22,
                    80
                  ]
                },
                {
                  "date_from": "2023-10-29",
                  "date_to": "2023-11-04",
                  "timestamp": 1698537600,
                  "values": [
                    17,
                    77
                  ]
                },
                {
                  "date_from": "2023-11-05",
                  "date_to": "2023-11-11",
                  "timestamp": 1699142400,
                  "values": [
                    7,
                    75
                  ]
                },
                {
                  "date_from": "2023-11-12",
                  "date_to": "2023-11-18",
                  "timestamp": 1699747200,
                  "values": [
                    7,
                    80
                  ]
                },
                {
                  "date_from": "2023-11-19",
                  "date_to": "2023-11-25",
                  "timestamp": 1700352000,
                  "values": [
                    4,
                    78
                  ]
                },
                {
                  "date_from": "2023-11-26",
                  "date_to": "2023-12-02",
                  "timestamp": 1700956800,
                  "values": [
                    7,
                    40
                  ]
                },
                {
                  "date_from": "2023-12-03",
                  "date_to": "2023-12-09",
                  "timestamp": 1701561600,
                  "values": [
                    7,
                    27
                  ]
                },
                {
                  "date_from": "2023-12-10",
                  "date_to": "2023-12-16",
                  "timestamp": 1702166400,
                  "values": [
                    5,
                    29
                  ]
                },
                {
                  "date_from": "2023-12-17",
                  "date_to": "2023-12-23",
                  "timestamp": 1702771200,
                  "values": [
                    7,
                    29
                  ]
                },
                {
                  "date_from": "2023-12-24",
                  "date_to": "2023-12-30",
                  "timestamp": 1703376000,
                  "values": [
                    6,
                    33
                  ]
                },
                {
                  "date_from": "2023-12-31",
                  "date_to": "2024-01-01",
                  "timestamp": 1703980800,
                  "values": [
                    11,
                    23
                  ]
                }
              ],
              "keywords": [
                "rugby",
                "cricket"
              ],
              "position": 1,
              "type": "dataforseo_trends_graph"
            },
            {
              "interests": [
                {
                  "keyword": "rugby",
                  "values": [
                    {
                      "geo_id": null,
                      "geo_name": "Alabama",
                      "value": 30
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Alaska",
                      "value": 0
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Arizona",
                      "value": 33
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Arkansas",
                      "value": 97
                    },
                    {
                      "geo_id": null,
                      "geo_name": "California",
                      "value": 46
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Colorado",
                      "value": 46
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Connecticut",
                      "value": 34
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Delaware",
                      "value": 14
                    },
                    {
                      "geo_id": null,
                      "geo_name": "District of Columbia",
                      "value": 89
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Florida",
                      "value": 26
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Georgia",
                      "value": 22
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Hawaii",
                      "value": 43
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Idaho",
                      "value": 48
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Illinois",
                      "value": 44
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Indiana",
                      "value": 43
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Iowa",
                      "value": 31
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Kansas",
                      "value": 18
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Kentucky",
                      "value": 12
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Louisiana",
                      "value": 35
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Maine",
                      "value": 53
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Maryland",
                      "value": 28
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Massachusetts",
                      "value": 48
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Michigan",
                      "value": 23
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Minnesota",
                      "value": 10
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Mississippi",
                      "value": 11
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Missouri",
                      "value": 29
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Montana",
                      "value": 53
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Nebraska",
                      "value": 43
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Nevada",
                      "value": 76
                    },
                    {
                      "geo_id": null,
                      "geo_name": "New Hampshire",
                      "value": 100
                    },
                    {
                      "geo_id": null,
                      "geo_name": "New Jersey",
                      "value": 50
                    },
                    {
                      "geo_id": null,
                      "geo_name": "New Mexico",
                      "value": 19
                    },
                    {
                      "geo_id": null,
                      "geo_name": "New York",
                      "value": 55
                    },
                    {
                      "geo_id": null,
                      "geo_name": "North Carolina",
                      "value": 59
                    },
                    {
                      "geo_id": null,
                      "geo_name": "North Dakota",
                      "value": 86
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Ohio",
                      "value": 45
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Oklahoma",
                      "value": 35
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Oregon",
                      "value": 36
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Pennsylvania",
                      "value": 38
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Rhode Island",
                      "value": 83
                    },
                    {
                      "geo_id": null,
                      "geo_name": "South Carolina",
                      "value": 36
                    },
                    {
                      "geo_id": null,
                      "geo_name": "South Dakota",
                      "value": 0
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Tennessee",
                      "value": 20
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Texas",
                      "value": 24
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Utah",
                      "value": 38
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Vermont",
                      "value": 57
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Virginia",
                      "value": 61
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Washington",
                      "value": 39
                    },
                    {
                      "geo_id": null,
                      "geo_name": "West Virginia",
                      "value": 11
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Wisconsin",
                      "value": 51
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Wyoming",
                      "value": 27
                    }
                  ]
                },
                {
                  "keyword": "cricket",
                  "values": [
                    {
                      "geo_id": null,
                      "geo_name": "Alabama",
                      "value": 33
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Alaska",
                      "value": 22
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Arizona",
                      "value": 74
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Arkansas",
                      "value": 54
                    },
                    {
                      "geo_id": null,
                      "geo_name": "California",
                      "value": 47
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Colorado",
                      "value": 32
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Connecticut",
                      "value": 41
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Delaware",
                      "value": 43
                    },
                    {
                      "geo_id": null,
                      "geo_name": "District of Columbia",
                      "value": 83
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Florida",
                      "value": 46
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Georgia",
                      "value": 59
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Hawaii",
                      "value": 13
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Idaho",
                      "value": 26
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Illinois",
                      "value": 50
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Indiana",
                      "value": 53
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Iowa",
                      "value": 35
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Kansas",
                      "value": 62
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Kentucky",
                      "value": 48
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Louisiana",
                      "value": 42
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Maine",
                      "value": 44
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Maryland",
                      "value": 48
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Massachusetts",
                      "value": 50
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Michigan",
                      "value": 37
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Minnesota",
                      "value": 42
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Mississippi",
                      "value": 68
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Missouri",
                      "value": 75
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Montana",
                      "value": 29
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Nebraska",
                      "value": 36
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Nevada",
                      "value": 34
                    },
                    {
                      "geo_id": null,
                      "geo_name": "New Hampshire",
                      "value": 34
                    },
                    {
                      "geo_id": null,
                      "geo_name": "New Jersey",
                      "value": 78
                    },
                    {
                      "geo_id": null,
                      "geo_name": "New Mexico",
                      "value": 29
                    },
                    {
                      "geo_id": null,
                      "geo_name": "New York",
                      "value": 58
                    },
                    {
                      "geo_id": null,
                      "geo_name": "North Carolina",
                      "value": 51
                    },
                    {
                      "geo_id": null,
                      "geo_name": "North Dakota",
                      "value": 100
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Ohio",
                      "value": 50
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Oklahoma",
                      "value": 60
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Oregon",
                      "value": 35
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Pennsylvania",
                      "value": 49
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Rhode Island",
                      "value": 38
                    },
                    {
                      "geo_id": null,
                      "geo_name": "South Carolina",
                      "value": 51
                    },
                    {
                      "geo_id": null,
                      "geo_name": "South Dakota",
                      "value": 47
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Tennessee",
                      "value": 52
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Texas",
                      "value": 70
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Utah",
                      "value": 28
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Vermont",
                      "value": 53
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Virginia",
                      "value": 64
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Washington",
                      "value": 39
                    },
                    {
                      "geo_id": null,
                      "geo_name": "West Virginia",
                      "value": 27
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Wisconsin",
                      "value": 41
                    },
                    {
                      "geo_id": null,
                      "geo_name": "Wyoming",
                      "value": 9
                    }
                  ]
                }
              ],
              "interests_comparison": {
                "absolute_items": [
                  {
                    "geo_id": null,
                    "geo_name": "Alabama",
                    "values": [
                      10,
                      33
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Alaska",
                    "values": [
                      0,
                      22
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Arizona",
                    "values": [
                      11,
                      74
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Arkansas",
                    "values": [
                      32,
                      54
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "California",
                    "values": [
                      15,
                      47
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Colorado",
                    "values": [
                      15,
                      32
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Connecticut",
                    "values": [
                      11,
                      41
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Delaware",
                    "values": [
                      5,
                      43
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "District of Columbia",
                    "values": [
                      29,
                      83
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Florida",
                    "values": [
                      9,
                      46
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Georgia",
                    "values": [
                      7,
                      59
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Hawaii",
                    "values": [
                      14,
                      13
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Idaho",
                    "values": [
                      16,
                      26
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Illinois",
                    "values": [
                      14,
                      50
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Indiana",
                    "values": [
                      14,
                      53
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Iowa",
                    "values": [
                      10,
                      35
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Kansas",
                    "values": [
                      6,
                      62
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Kentucky",
                    "values": [
                      4,
                      48
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Louisiana",
                    "values": [
                      12,
                      42
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Maine",
                    "values": [
                      17,
                      44
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Maryland",
                    "values": [
                      9,
                      48
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Massachusetts",
                    "values": [
                      16,
                      50
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Michigan",
                    "values": [
                      8,
                      37
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Minnesota",
                    "values": [
                      3,
                      42
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Mississippi",
                    "values": [
                      4,
                      68
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Missouri",
                    "values": [
                      9,
                      75
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Montana",
                    "values": [
                      18,
                      29
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Nebraska",
                    "values": [
                      14,
                      36
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Nevada",
                    "values": [
                      25,
                      34
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "New Hampshire",
                    "values": [
                      33,
                      34
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "New Jersey",
                    "values": [
                      17,
                      78
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "New Mexico",
                    "values": [
                      6,
                      29
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "New York",
                    "values": [
                      18,
                      58
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "North Carolina",
                    "values": [
                      19,
                      51
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "North Dakota",
                    "values": [
                      29,
                      100
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Ohio",
                    "values": [
                      15,
                      50
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Oklahoma",
                    "values": [
                      11,
                      60
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Oregon",
                    "values": [
                      12,
                      35
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Pennsylvania",
                    "values": [
                      13,
                      49
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Rhode Island",
                    "values": [
                      28,
                      38
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "South Carolina",
                    "values": [
                      12,
                      51
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "South Dakota",
                    "values": [
                      0,
                      47
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Tennessee",
                    "values": [
                      7,
                      52
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Texas",
                    "values": [
                      8,
                      70
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Utah",
                    "values": [
                      13,
                      28
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Vermont",
                    "values": [
                      19,
                      53
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Virginia",
                    "values": [
                      20,
                      64
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Washington",
                    "values": [
                      13,
                      39
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "West Virginia",
                    "values": [
                      4,
                      27
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Wisconsin",
                    "values": [
                      17,
                      41
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Wyoming",
                    "values": [
                      9,
                      9
                    ]
                  }
                ],
                "items": [
                  {
                    "geo_id": null,
                    "geo_name": "Alabama",
                    "values": [
                      23,
                      77
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Alaska",
                    "values": [
                      0,
                      100
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Arizona",
                    "values": [
                      13,
                      87
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Arkansas",
                    "values": [
                      37,
                      63
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "California",
                    "values": [
                      24,
                      76
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Colorado",
                    "values": [
                      32,
                      68
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Connecticut",
                    "values": [
                      22,
                      78
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Delaware",
                    "values": [
                      10,
                      90
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "District of Columbia",
                    "values": [
                      26,
                      74
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Florida",
                    "values": [
                      16,
                      84
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Georgia",
                    "values": [
                      11,
                      89
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Hawaii",
                    "values": [
                      52,
                      48
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Idaho",
                    "values": [
                      38,
                      62
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Illinois",
                    "values": [
                      22,
                      78
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Indiana",
                    "values": [
                      21,
                      79
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Iowa",
                    "values": [
                      22,
                      78
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Kansas",
                    "values": [
                      9,
                      91
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Kentucky",
                    "values": [
                      8,
                      92
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Louisiana",
                    "values": [
                      22,
                      78
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Maine",
                    "values": [
                      29,
                      71
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Maryland",
                    "values": [
                      16,
                      84
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Massachusetts",
                    "values": [
                      24,
                      76
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Michigan",
                    "values": [
                      17,
                      83
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Minnesota",
                    "values": [
                      8,
                      92
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Mississippi",
                    "values": [
                      5,
                      95
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Missouri",
                    "values": [
                      11,
                      89
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Montana",
                    "values": [
                      38,
                      63
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Nebraska",
                    "values": [
                      29,
                      71
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Nevada",
                    "values": [
                      42,
                      58
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "New Hampshire",
                    "values": [
                      49,
                      51
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "New Jersey",
                    "values": [
                      18,
                      82
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "New Mexico",
                    "values": [
                      18,
                      82
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "New York",
                    "values": [
                      24,
                      76
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "North Carolina",
                    "values": [
                      28,
                      72
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "North Dakota",
                    "values": [
                      22,
                      78
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Ohio",
                    "values": [
                      23,
                      77
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Oklahoma",
                    "values": [
                      16,
                      84
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Oregon",
                    "values": [
                      26,
                      74
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Pennsylvania",
                    "values": [
                      21,
                      79
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Rhode Island",
                    "values": [
                      42,
                      58
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "South Carolina",
                    "values": [
                      19,
                      81
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "South Dakota",
                    "values": [
                      0,
                      100
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Tennessee",
                    "values": [
                      11,
                      89
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Texas",
                    "values": [
                      10,
                      90
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Utah",
                    "values": [
                      31,
                      69
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Vermont",
                    "values": [
                      26,
                      74
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Virginia",
                    "values": [
                      24,
                      76
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Washington",
                    "values": [
                      25,
                      75
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "West Virginia",
                    "values": [
                      13,
                      88
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Wisconsin",
                    "values": [
                      29,
                      71
                    ]
                  },
                  {
                    "geo_id": null,
                    "geo_name": "Wyoming",
                    "values": [
                      50,
                      50
                    ]
                  }
                ]
              },
              "keywords": [
                "rugby",
                "cricket"
              ],
              "position": 2,
              "type": "subregion_interests"
            },
            {
              "demography": {
                "age": [
                  {
                    "keyword": "rugby",
                    "values": [
                      {
                        "type": "18-24",
                        "value": 73
                      },
                      {
                        "type": "25-34",
                        "value": 87
                      },
                      {
                        "type": "35-44",
                        "value": 91
                      },
                      {
                        "type": "45-54",
                        "value": 100
                      },
                      {
                        "type": "55-64",
                        "value": 49
                      }
                    ]
                  },
                  {
                    "keyword": "cricket",
                    "values": [
                      {
                        "type": "18-24",
                        "value": 42
                      },
                      {
                        "type": "25-34",
                        "value": 79
                      },
                      {
                        "type": "35-44",
                        "value": 100
                      },
                      {
                        "type": "45-54",
                        "value": 74
                      },
                      {
                        "type": "55-64",
                        "value": 39
                      }
                    ]
                  }
                ],
                "gender": [
                  {
                    "keyword": "rugby",
                    "values": [
                      {
                        "type": "female",
                        "value": 79
                      },
                      {
                        "type": "male",
                        "value": 100
                      }
                    ]
                  },
                  {
                    "keyword": "cricket",
                    "values": [
                      {
                        "type": "female",
                        "value": 83
                      },
                      {
                        "type": "male",
                        "value": 100
                      }
                    ]
                  }
                ]
              },
              "demography_comparison": {
                "age": {
                  "18-24": [
                    30,
                    70
                  ],
                  "25-34": [
                    22,
                    78
                  ],
                  "35-44": [
                    18,
                    82
                  ],
                  "45-54": [
                    25,
                    75
                  ],
                  "55-64": [
                    24,
                    76
                  ]
                },
                "gender": {
                  "female": [
                    20,
                    80
                  ],
                  "male": [
                    20,
                    80
                  ]
                }
              },
              "keywords": [
                "rugby",
                "cricket"
              ],
              "position": 3,
              "type": "demography"
            }
          ],
          "items_count": 3,
          "keywords": [
            "rugby",
            "cricket"
          ],
          "language_code": null,
          "location_code": 2840,
          "type": "trends"
        }
      ],
      "result_count": 1,
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.5700 sec."
    }
  ],
  "tasks_count": 1,
  "tasks_error": 0,
  "time": "0.6291 sec.",
  "version": "0.1.20231117"
}

Response result

Response structure

Inferred from examples
  • costnumber
  • status_codeinteger
  • status_messagestring
  • tasksobject[]
    • costnumber
    • dataobject
      • apistring
      • date_fromstring
      • date_tostring
      • functionstring
      • keywordsstring[]
      • location_namestring
      • sestring
      • typestring
    • idstring
    • pathstring[]
    • resultobject[]
      • datetimestring
      • itemsobject[]
        • averagesinteger[]
        • dataobject[]
          • date_fromstring
          • date_tostring
          • timestampinteger
          • valuesinteger[]
        • keywordsstring[]
        • positioninteger
        • typestring
        • interestsobject[]
          • keywordstring
          • valuesobject[]
            • geo_idnull
            • geo_namestring
            • valueinteger
        • interests_comparisonobject
          • absolute_itemsobject[]
            • geo_idnull
            • geo_namestring
            • valuesinteger[]
          • itemsobject[]
            • geo_idnull
            • geo_namestring
            • valuesinteger[]
        • demographyobject
          • ageobject[]
            • keywordstring
            • valuesobject[]
              • typeunknown
              • valueunknown
          • genderobject[]
            • keywordstring
            • valuesobject[]
              • typeunknown
              • valueunknown
        • demography_comparisonobject
          • ageobject
            • 18-24integer[]
            • 25-34integer[]
            • 35-44integer[]
            • 45-54integer[]
            • 55-64integer[]
          • genderobject
            • femaleinteger[]
            • maleinteger[]
      • items_countinteger
      • keywordsstring[]
      • language_codenull
      • location_codeinteger
      • typestring
    • result_countinteger
    • status_codeinteger
    • status_messagestring
    • timestring
  • tasks_countinteger
  • tasks_errorinteger
  • timestring
  • versionstring

Common questions

Do I need a separate key for every provider?

Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.

Are these providers interchangeable?

No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.

How is this API billed?

API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.

Where do the price and contract come from?

The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.

How do OpenAny Balance and x402 differ?

OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.

Does Playground send a paid request?

Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.

Use DataForSEO — Keywords Data / Dataforseo Trends / Merged Data / Live with your agent

Inspect endpoint contracts and confirm availability and pricing before a paid call.