What is global search volume?

Keyword Data API
Table of Contents

Global search volume is the total number of times a keyword is searched worldwide in an average month, added up across all countries rather than measured in a single location. It’s the figure to check when you need keywords for global, worldwide, or international reach, and its country-by-country breakdown shows how that demand spreads across the globe and how wide a keyword’s regional scope is.

A single-country search volume value can hide most of the picture. When we checked “seo tools” in October 2026, it had 218,232 monthly searches worldwide, but only 6.1% of them came from the United States. Vietnam and India together brought in 61.5%. Size that keyword by US volume alone, and you miss more than 90% of its demand.

Our Keyword Data API returns this metric through the Global Search Volume endpoint: up to 1,000 keywords per request, each with a worldwide total, the volume in every country where it’s searched, and that country’s percentage share. SEO software builders can use it to create worldwide demand maps, and agencies can use it to determine which markets require localized content.

How global search volume is calculated

Our global search volume is clickstream-based. Clickstream data is an anonymized record of real users’ searches and clicks, which we source from third-party providers and refine before use. If you want the background on where this data comes from and what it can show, read our blog post that explains all key aspects of the clickstream data.

The worldwide figure comes together in three steps:

  1. For each country, we take the clickstream events tied to the keyword and multiply them by our proprietary coefficients derived mainly from the ratio between the number of devices in the data and the overall number of internet users. The result is the keyword’s clickstream search volume in that country, an estimate of its average monthly searches there.
  2. We sum the per-country values. That sum is the keyword’s global search volume.
  3. We divide each country’s value by the global total to get its percentage share.

Since every country’s figure comes from the same model, the country values in a response add up to the global total, rounding aside. That’s what makes the breakdown safe to use when you compare markets against each other.

Global vs local search volume: country and city level

Global, country-level, and city-level search volumes answer different questions, and our APIs return each one from a different endpoint:

  • Global search volume is a keyword’s total worldwide demand, split by country. Use it to find out where a keyword is worth pursuing, especially when you research international keywords. Endpoint: Global Search Volume.
  • Country-level search volume is demand inside one market, with month-by-month history. Use it to size a market you already target. Endpoints: DataForSEO Search Volume (clickstream-based) or Google Ads Search Volume, with the country set in location_code (for example, 2840 for the United States).
  • City-level search volume narrows demand down to one city, which matters for local SEO and geo-targeted PPC. Endpoint: Google Ads Search Volume with a city in location_name, such as London,England,United Kingdom.

A practical order is to start global, shortlist the countries with the largest shares, and then pull country- or city-level data for those markets only. Just don’t mix sources in one calculation: Google Ads values for individual countries won’t add up to a clickstream-based global total.

How to get worldwide keyword search volume via the API

The Global Search Volume endpoint requires only one parameter, keywords. There’s no location or language to set, because the endpoint returns global keyword data for all available countries by design.

Endpoint used: POST https://api.dataforseo.com/v3/keywords_data/clickstream_data/global_search_volume/live

A few rules for the request:

  • You can send up to 1,000 keywords in the keywords array of a single request.
  • Each keyword must be at least 3 characters long, and emojis or certain UTF symbols aren’t accepted.
  • Keywords are converted to lowercase, so “SEO Tools” and “seo tools” are treated as the same query.
  • The optional tag field lets you label the task and find the same value in the data object of the response.

Request example:

[
  {
    "keywords": [
      "keyword research",
      "search volume",
      "seo tools"
    ]
  }
]

Response example:

{
  "version": "0.1.20261022",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.1187 sec.",
  "cost": 0.18,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "10301142-1535-0592-0000-7208189604f8",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0858 sec.",
      "cost": 0.18,
      "result_count": 1,
      "path": [
        "v3",
        "keywords_data",
        "clickstream_data",
        "global_search_volume",
        "live"
      ],
      "data": {
        "api": "keywords_data",
        "function": "global_search_volume",
        "se": "clickstream_data",
        "keywords": [
          "keyword research",
          "search volume",
          "seo tools"
        ]
      },
      "result": [
        {
          "items_count": 3,
          "items": [
            {
              "keyword": "seo tools",
              "search_volume": 218232,
              "country_distribution": [
                {
                  "country_iso_code": "VN",
                  "search_volume": 86305,
                  "percentage": 39.54762
                },
                {
                  "country_iso_code": "IN",
                  "search_volume": 47880,
                  "percentage": 21.93993
                },
                {
                  "country_iso_code": "US",
                  "search_volume": 13347,
                  "percentage": 6.11608
                },
                {
                  "country_iso_code": "PK",
                  "search_volume": 12094,
                  "percentage": 5.54184
                },
                {
                  "country_iso_code": "DE",
                  "search_volume": 6624,
                  "percentage": 3.03549
                },
                {
                  "country_iso_code": "GB",
                  "search_volume": 5277,
                  "percentage": 2.41837
                },
                {
                  "country_iso_code": "BD",
                  "search_volume": 5066,
                  "percentage": 2.32169
                },
                {
                  "country_iso_code": "ID",
                  "search_volume": 3255,
                  "percentage": 1.49172
                },
                {
                  "country_iso_code": "TR",
                  "search_volume": 2529,
                  "percentage": 1.1589
                },
                {
                  "country_iso_code": "FR",
                  "search_volume": 2315,
                  "percentage": 1.06103
                },
                {
                  "country_iso_code": "PH",
                  "search_volume": 2119,
                  "percentage": 0.97129
                },
                {
                  "country_iso_code": "NG",
                  "search_volume": 1920,
                  "percentage": 0.8798
                },
                {
                  "country_iso_code": "CA",
                  "search_volume": 1807,
                  "percentage": 0.82802
                },
                {
                  "country_iso_code": "EG",
                  "search_volume": 1559,
                  "percentage": 0.71468
                },
                {
                  "country_iso_code": "IT",
                  "search_volume": 1267,
                  "percentage": 0.58092
                },
                {
                  "country_iso_code": "ZA",
                  "search_volume": 1228,
                  "percentage": 0.56286
                },
                {
                  "country_iso_code": "ES",
                  "search_volume": 1208,
                  "percentage": 0.55377
                },
                {
                  "country_iso_code": "NL",
                  "search_volume": 1134,
                  "percentage": 0.51997
                },
                {
                  "country_iso_code": "MA",
                  "search_volume": 1029,
                  "percentage": 0.47167
                },
                {
                  "country_iso_code": "AU",
                  "search_volume": 963,
                  "percentage": 0.44139
                },
                {
                  "country_iso_code": "AE",
                  "search_volume": 943,
                  "percentage": 0.43234
                },
                {
                  "country_iso_code": "BR",
                  "search_volume": 917,
                  "percentage": 0.42031
                },
                {
                  "country_iso_code": "MX",
                  "search_volume": 905,
                  "percentage": 0.41481
                },
                {
                  "country_iso_code": "NP",
                  "search_volume": 842,
                  "percentage": 0.38587
                },
                {
                  "country_iso_code": "CH",
                  "search_volume": 761,
                  "percentage": 0.34875
                },
                {
                  "country_iso_code": "GH",
                  "search_volume": 699,
                  "percentage": 0.32072
                },
                {
                  "country_iso_code": "KE",
                  "search_volume": 658,
                  "percentage": 0.30155
                },
                {
                  "country_iso_code": "JP",
                  "search_volume": 656,
                  "percentage": 0.3006
                },
                {
                  "country_iso_code": "DK",
                  "search_volume": 612,
                  "percentage": 0.28074
                },
                {
                  "country_iso_code": "HU",
                  "search_volume": 585,
                  "percentage": 0.26829
                },
                {
                  "country_iso_code": "PL",
                  "search_volume": 538,
                  "percentage": 0.24695
                },
                {
                  "country_iso_code": "TH",
                  "search_volume": 528,
                  "percentage": 0.24236
                },
                {
                  "country_iso_code": "UA",
                  "search_volume": 490,
                  "percentage": 0.22495
                },
                {
                  "country_iso_code": "MY",
                  "search_volume": 465,
                  "percentage": 0.21346
                },
                {
                  "country_iso_code": "RO",
                  "search_volume": 434,
                  "percentage": 0.1991
                },
                {
                  "country_iso_code": "SA",
                  "search_volume": 431,
                  "percentage": 0.19776
                },
                {
                  "country_iso_code": "GR",
                  "search_volume": 413,
                  "percentage": 0.18925
                },
                {
                  "country_iso_code": "AT",
                  "search_volume": 403,
                  "percentage": 0.18493
                },
                {
                  "country_iso_code": "RU",
                  "search_volume": 397,
                  "percentage": 0.18218
                },
                {
                  "country_iso_code": "TW",
                  "search_volume": 366,
                  "percentage": 0.16813
                },
                {
                  "country_iso_code": "CO",
                  "search_volume": 340,
                  "percentage": 0.15606
                },
                {
                  "country_iso_code": "IR",
                  "search_volume": 333,
                  "percentage": 0.15274
                },
                {
                  "country_iso_code": "DZ",
                  "search_volume": 317,
                  "percentage": 0.14541
                },
                {
                  "country_iso_code": "BG",
                  "search_volume": 309,
                  "percentage": 0.14178
                },
                {
                  "country_iso_code": "SK",
                  "search_volume": 305,
                  "percentage": 0.14003
                },
                {
                  "country_iso_code": "IE",
                  "search_volume": 297,
                  "percentage": 0.13651
                },
                {
                  "country_iso_code": "LK",
                  "search_volume": 285,
                  "percentage": 0.13101
                },
                {
                  "country_iso_code": "SG",
                  "search_volume": 243,
                  "percentage": 0.11139
                },
                {
                  "country_iso_code": "IL",
                  "search_volume": 207,
                  "percentage": 0.09497
                },
                {
                  "country_iso_code": "RS",
                  "search_volume": 207,
                  "percentage": 0.0952
                },
                {
                  "country_iso_code": "AR",
                  "search_volume": 206,
                  "percentage": 0.09459
                },
                {
                  "country_iso_code": "ET",
                  "search_volume": 200,
                  "percentage": 0.09165
                },
                {
                  "country_iso_code": "TM",
                  "search_volume": 200,
                  "percentage": 0.09165
                },
                {
                  "country_iso_code": "SN",
                  "search_volume": 185,
                  "percentage": 0.08504
                },
                {
                  "country_iso_code": "AM",
                  "search_volume": 162,
                  "percentage": 0.07461
                },
                {
                  "country_iso_code": "FI",
                  "search_volume": 162,
                  "percentage": 0.07427
                },
                {
                  "country_iso_code": "LT",
                  "search_volume": 158,
                  "percentage": 0.07255
                },
                {
                  "country_iso_code": "TN",
                  "search_volume": 142,
                  "percentage": 0.06514
                },
                {
                  "country_iso_code": "KZ",
                  "search_volume": 137,
                  "percentage": 0.06316
                },
                {
                  "country_iso_code": "UZ",
                  "search_volume": 133,
                  "percentage": 0.0611
                },
                {
                  "country_iso_code": "AF",
                  "search_volume": 133,
                  "percentage": 0.0611
                },
                {
                  "country_iso_code": "ZW",
                  "search_volume": 133,
                  "percentage": 0.0611
                },
                {
                  "country_iso_code": "ZM",
                  "search_volume": 133,
                  "percentage": 0.0611
                },
                {
                  "country_iso_code": "IQ",
                  "search_volume": 133,
                  "percentage": 0.0611
                },
                {
                  "country_iso_code": "PE",
                  "search_volume": 122,
                  "percentage": 0.05625
                },
                {
                  "country_iso_code": "NO",
                  "search_volume": 118,
                  "percentage": 0.05422
                },
                {
                  "country_iso_code": "EE",
                  "search_volume": 104,
                  "percentage": 0.04785
                },
                {
                  "country_iso_code": "KH",
                  "search_volume": 87,
                  "percentage": 0.03987
                },
                {
                  "country_iso_code": "VE",
                  "search_volume": 86,
                  "percentage": 0.03971
                },
                {
                  "country_iso_code": "PT",
                  "search_volume": 78,
                  "percentage": 0.03582
                },
                {
                  "country_iso_code": "KW",
                  "search_volume": 78,
                  "percentage": 0.03578
                },
                {
                  "country_iso_code": "HK",
                  "search_volume": 76,
                  "percentage": 0.03483
                },
                {
                  "country_iso_code": "SE",
                  "search_volume": 73,
                  "percentage": 0.03353
                },
                {
                  "country_iso_code": "KR",
                  "search_volume": 71,
                  "percentage": 0.03288
                },
                {
                  "country_iso_code": "NZ",
                  "search_volume": 70,
                  "percentage": 0.03211
                },
                {
                  "country_iso_code": "CL",
                  "search_volume": 66,
                  "percentage": 0.03059
                },
                {
                  "country_iso_code": "TZ",
                  "search_volume": 66,
                  "percentage": 0.03055
                },
                {
                  "country_iso_code": "MM",
                  "search_volume": 66,
                  "percentage": 0.03055
                },
                {
                  "country_iso_code": "CZ",
                  "search_volume": 66,
                  "percentage": 0.03032
                },
                {
                  "country_iso_code": "UG",
                  "search_volume": 66,
                  "percentage": 0.03055
                },
                {
                  "country_iso_code": "PG",
                  "search_volume": 66,
                  "percentage": 0.03055
                },
                {
                  "country_iso_code": "QA",
                  "search_volume": 64,
                  "percentage": 0.0294
                },
                {
                  "country_iso_code": "JO",
                  "search_volume": 63,
                  "percentage": 0.0291
                },
                {
                  "country_iso_code": "CY",
                  "search_volume": 62,
                  "percentage": 0.02872
                },
                {
                  "country_iso_code": "GE",
                  "search_volume": 54,
                  "percentage": 0.02494
                },
                {
                  "country_iso_code": "NA",
                  "search_volume": 51,
                  "percentage": 0.02348
                },
                {
                  "country_iso_code": "BE",
                  "search_volume": 48,
                  "percentage": 0.02203
                },
                {
                  "country_iso_code": "GA",
                  "search_volume": 43,
                  "percentage": 0.01993
                },
                {
                  "country_iso_code": "PS",
                  "search_volume": 41,
                  "percentage": 0.01879
                },
                {
                  "country_iso_code": "BY",
                  "search_volume": 40,
                  "percentage": 0.01871
                },
                {
                  "country_iso_code": "OM",
                  "search_volume": 35,
                  "percentage": 0.01646
                },
                {
                  "country_iso_code": "TG",
                  "search_volume": 33,
                  "percentage": 0.01539
                },
                {
                  "country_iso_code": "MU",
                  "search_volume": 32,
                  "percentage": 0.01501
                },
                {
                  "country_iso_code": "DO",
                  "search_volume": 32,
                  "percentage": 0.01505
                },
                {
                  "country_iso_code": "AL",
                  "search_volume": 30,
                  "percentage": 0.01379
                },
                {
                  "country_iso_code": "BO",
                  "search_volume": 29,
                  "percentage": 0.01356
                },
                {
                  "country_iso_code": "CR",
                  "search_volume": 26,
                  "percentage": 0.01207
                },
                {
                  "country_iso_code": "LV",
                  "search_volume": 26,
                  "percentage": 0.01195
                },
                {
                  "country_iso_code": "MK",
                  "search_volume": 24,
                  "percentage": 0.01142
                },
                {
                  "country_iso_code": null,
                  "search_volume": 23,
                  "percentage": 0.01065
                },
                {
                  "country_iso_code": "MT",
                  "search_volume": 22,
                  "percentage": 0.01046
                },
                {
                  "country_iso_code": "LU",
                  "search_volume": 13,
                  "percentage": 0.00638
                },
                {
                  "country_iso_code": "GI",
                  "search_volume": 7,
                  "percentage": 0.00347
                }
              ]
            },
            {
              "keyword": "keyword research",
              "search_volume": 168588,
              "country_distribution": [
                {
                  "country_iso_code": "IN",
                  "search_volume": 77186,
                  "percentage": 45.7842
                },
                {
                  "country_iso_code": "BD",
                  "search_volume": 22133,
                  "percentage": 13.12865
                },
                {
                  "country_iso_code": "PK",
                  "search_volume": 13090,
                  "percentage": 7.76503
                },
                {
                  "country_iso_code": "US",
                  "search_volume": 9102,
                  "percentage": 5.39936
                },
                {
                  "country_iso_code": "GB",
                  "search_volume": 4558,
                  "percentage": 2.70363
                },
                {
                  "country_iso_code": "DE",
                  "search_volume": 3933,
                  "percentage": 2.33305
                },
                {
                  "country_iso_code": "NG",
                  "search_volume": 2880,
                  "percentage": 1.70831
                },
                {
                  "country_iso_code": "ID",
                  "search_volume": 2480,
                  "percentage": 1.47124
                },
                {
                  "country_iso_code": "EG",
                  "search_volume": 1811,
                  "percentage": 1.07436
                },
                {
                  "country_iso_code": "ES",
                  "search_volume": 1726,
                  "percentage": 1.02409
                },
                {
                  "country_iso_code": "VN",
                  "search_volume": 1634,
                  "percentage": 0.96928
                },
                {
                  "country_iso_code": "IR",
                  "search_volume": 1533,
                  "percentage": 0.90952
                },
                {
                  "country_iso_code": "AU",
                  "search_volume": 1423,
                  "percentage": 0.84461
                },
                {
                  "country_iso_code": "TH",
                  "search_volume": 1410,
                  "percentage": 0.83666
                },
                {
                  "country_iso_code": "TR",
                  "search_volume": 1386,
                  "percentage": 0.82267
                },
                {
                  "country_iso_code": "CA",
                  "search_volume": 1320,
                  "percentage": 0.78327
                },
                {
                  "country_iso_code": "KE",
                  "search_volume": 1243,
                  "percentage": 0.73735
                },
                {
                  "country_iso_code": "NP",
                  "search_volume": 1089,
                  "percentage": 0.6464
                },
                {
                  "country_iso_code": "NL",
                  "search_volume": 1085,
                  "percentage": 0.64383
                },
                {
                  "country_iso_code": "IT",
                  "search_volume": 1056,
                  "percentage": 0.62663
                },
                {
                  "country_iso_code": "JP",
                  "search_volume": 984,
                  "percentage": 0.58372
                },
                {
                  "country_iso_code": "SA",
                  "search_volume": 971,
                  "percentage": 0.57596
                },
                {
                  "country_iso_code": "MX",
                  "search_volume": 905,
                  "percentage": 0.53696
                },
                {
                  "country_iso_code": "ZA",
                  "search_volume": 884,
                  "percentage": 0.5246
                },
                {
                  "country_iso_code": "PH",
                  "search_volume": 800,
                  "percentage": 0.47497
                },
                {
                  "country_iso_code": "FR",
                  "search_volume": 795,
                  "percentage": 0.47211
                },
                {
                  "country_iso_code": "MA",
                  "search_volume": 794,
                  "percentage": 0.47097
                },
                {
                  "country_iso_code": "AE",
                  "search_volume": 683,
                  "percentage": 0.40523
                },
                {
                  "country_iso_code": "GH",
                  "search_volume": 559,
                  "percentage": 0.33212
                },
                {
                  "country_iso_code": "RO",
                  "search_volume": 434,
                  "percentage": 0.25773
                },
                {
                  "country_iso_code": "RS",
                  "search_volume": 415,
                  "percentage": 0.24646
                },
                {
                  "country_iso_code": "IL",
                  "search_volume": 414,
                  "percentage": 0.24587
                },
                {
                  "country_iso_code": "LK",
                  "search_volume": 400,
                  "percentage": 0.23741
                },
                {
                  "country_iso_code": "SG",
                  "search_volume": 353,
                  "percentage": 0.20973
                },
                {
                  "country_iso_code": "AR",
                  "search_volume": 353,
                  "percentage": 0.20988
                },
                {
                  "country_iso_code": "MY",
                  "search_volume": 341,
                  "percentage": 0.20261
                },
                {
                  "country_iso_code": "CO",
                  "search_volume": 340,
                  "percentage": 0.20202
                },
                {
                  "country_iso_code": "BR",
                  "search_volume": 337,
                  "percentage": 0.20044
                },
                {
                  "country_iso_code": "DK",
                  "search_volume": 334,
                  "percentage": 0.19821
                },
                {
                  "country_iso_code": "CH",
                  "search_volume": 317,
                  "percentage": 0.18808
                },
                {
                  "country_iso_code": "PL",
                  "search_volume": 307,
                  "percentage": 0.18264
                },
                {
                  "country_iso_code": "FI",
                  "search_volume": 243,
                  "percentage": 0.14424
                },
                {
                  "country_iso_code": "BE",
                  "search_volume": 240,
                  "percentage": 0.1427
                },
                {
                  "country_iso_code": "DZ",
                  "search_volume": 226,
                  "percentage": 0.13445
                },
                {
                  "country_iso_code": "NZ",
                  "search_volume": 210,
                  "percentage": 0.12476
                },
                {
                  "country_iso_code": "GR",
                  "search_volume": 206,
                  "percentage": 0.12249
                },
                {
                  "country_iso_code": "AF",
                  "search_volume": 200,
                  "percentage": 0.11863
                },
                {
                  "country_iso_code": "PE",
                  "search_volume": 196,
                  "percentage": 0.11651
                },
                {
                  "country_iso_code": "NO",
                  "search_volume": 177,
                  "percentage": 0.10529
                },
                {
                  "country_iso_code": "AM",
                  "search_volume": 162,
                  "percentage": 0.09659
                },
                {
                  "country_iso_code": "LT",
                  "search_volume": 158,
                  "percentage": 0.09392
                },
                {
                  "country_iso_code": "SE",
                  "search_volume": 146,
                  "percentage": 0.0868
                },
                {
                  "country_iso_code": "KR",
                  "search_volume": 143,
                  "percentage": 0.08512
                },
                {
                  "country_iso_code": "PR",
                  "search_volume": 138,
                  "percentage": 0.0822
                },
                {
                  "country_iso_code": "CZ",
                  "search_volume": 132,
                  "percentage": 0.0785
                },
                {
                  "country_iso_code": "HU",
                  "search_volume": 106,
                  "percentage": 0.06312
                },
                {
                  "country_iso_code": "BG",
                  "search_volume": 103,
                  "percentage": 0.06115
                },
                {
                  "country_iso_code": "RU",
                  "search_volume": 99,
                  "percentage": 0.05892
                },
                {
                  "country_iso_code": "DO",
                  "search_volume": 98,
                  "percentage": 0.05853
                },
                {
                  "country_iso_code": "AZ",
                  "search_volume": 88,
                  "percentage": 0.0522
                },
                {
                  "country_iso_code": "PA",
                  "search_volume": 83,
                  "percentage": 0.04968
                },
                {
                  "country_iso_code": "AT",
                  "search_volume": 80,
                  "percentage": 0.04785
                },
                {
                  "country_iso_code": "HK",
                  "search_volume": 76,
                  "percentage": 0.04508
                },
                {
                  "country_iso_code": "TN",
                  "search_volume": 71,
                  "percentage": 0.04216
                },
                {
                  "country_iso_code": "KZ",
                  "search_volume": 68,
                  "percentage": 0.04088
                },
                {
                  "country_iso_code": "CL",
                  "search_volume": 66,
                  "percentage": 0.03959
                },
                {
                  "country_iso_code": "IQ",
                  "search_volume": 66,
                  "percentage": 0.03954
                },
                {
                  "country_iso_code": "SY",
                  "search_volume": 66,
                  "percentage": 0.03954
                },
                {
                  "country_iso_code": "TZ",
                  "search_volume": 66,
                  "percentage": 0.03954
                },
                {
                  "country_iso_code": "ZW",
                  "search_volume": 66,
                  "percentage": 0.03954
                },
                {
                  "country_iso_code": "GQ",
                  "search_volume": 66,
                  "percentage": 0.03954
                },
                {
                  "country_iso_code": "CM",
                  "search_volume": 66,
                  "percentage": 0.03954
                },
                {
                  "country_iso_code": "GM",
                  "search_volume": 66,
                  "percentage": 0.03954
                },
                {
                  "country_iso_code": "IE",
                  "search_volume": 59,
                  "percentage": 0.03534
                },
                {
                  "country_iso_code": "SO",
                  "search_volume": 52,
                  "percentage": 0.03104
                },
                {
                  "country_iso_code": "RW",
                  "search_volume": 45,
                  "percentage": 0.02709
                },
                {
                  "country_iso_code": "TW",
                  "search_volume": 45,
                  "percentage": 0.02719
                },
                {
                  "country_iso_code": "QA",
                  "search_volume": 42,
                  "percentage": 0.02536
                },
                {
                  "country_iso_code": "HR",
                  "search_volume": 42,
                  "percentage": 0.02516
                },
                {
                  "country_iso_code": "PT",
                  "search_volume": 39,
                  "percentage": 0.02318
                },
                {
                  "country_iso_code": null,
                  "search_volume": 38,
                  "percentage": 0.02254
                },
                {
                  "country_iso_code": "BA",
                  "search_volume": 38,
                  "percentage": 0.02308
                },
                {
                  "country_iso_code": "TG",
                  "search_volume": 33,
                  "percentage": 0.01992
                },
                {
                  "country_iso_code": "CY",
                  "search_volume": 31,
                  "percentage": 0.01859
                },
                {
                  "country_iso_code": "EC",
                  "search_volume": 30,
                  "percentage": 0.01804
                },
                {
                  "country_iso_code": "AL",
                  "search_volume": 30,
                  "percentage": 0.01784
                },
                {
                  "country_iso_code": "NI",
                  "search_volume": 30,
                  "percentage": 0.01824
                },
                {
                  "country_iso_code": "SV",
                  "search_volume": 29,
                  "percentage": 0.0177
                },
                {
                  "country_iso_code": "GE",
                  "search_volume": 27,
                  "percentage": 0.01611
                },
                {
                  "country_iso_code": "LV",
                  "search_volume": 26,
                  "percentage": 0.01547
                },
                {
                  "country_iso_code": "CR",
                  "search_volume": 26,
                  "percentage": 0.01562
                },
                {
                  "country_iso_code": "MK",
                  "search_volume": 24,
                  "percentage": 0.01478
                },
                {
                  "country_iso_code": "VC",
                  "search_volume": 23,
                  "percentage": 0.01384
                },
                {
                  "country_iso_code": "MT",
                  "search_volume": 22,
                  "percentage": 0.01354
                },
                {
                  "country_iso_code": "BB",
                  "search_volume": 15,
                  "percentage": 0.00934
                },
                {
                  "country_iso_code": "JM",
                  "search_volume": 15,
                  "percentage": 0.00919
                },
                {
                  "country_iso_code": "SC",
                  "search_volume": 6,
                  "percentage": 0.00376
                }
              ]
            },
            {
              "keyword": "search volume",
              "search_volume": 14615,
              "country_distribution": [
                {
                  "country_iso_code": "IN",
                  "search_volume": 4106,
                  "percentage": 28.09754
                },
                {
                  "country_iso_code": "FR",
                  "search_volume": 1736,
                  "percentage": 11.88216
                },
                {
                  "country_iso_code": "BD",
                  "search_volume": 933,
                  "percentage": 6.38581
                },
                {
                  "country_iso_code": "GB",
                  "search_volume": 879,
                  "percentage": 6.01805
                },
                {
                  "country_iso_code": "US",
                  "search_volume": 869,
                  "percentage": 5.94792
                },
                {
                  "country_iso_code": "PK",
                  "search_volume": 863,
                  "percentage": 5.91029
                },
                {
                  "country_iso_code": "VN",
                  "search_volume": 847,
                  "percentage": 5.79683
                },
                {
                  "country_iso_code": "TH",
                  "search_volume": 528,
                  "percentage": 3.61881
                },
                {
                  "country_iso_code": "TR",
                  "search_volume": 326,
                  "percentage": 2.23275
                },
                {
                  "country_iso_code": "ID",
                  "search_volume": 310,
                  "percentage": 2.121
                },
                {
                  "country_iso_code": "DE",
                  "search_volume": 310,
                  "percentage": 2.12442
                },
                {
                  "country_iso_code": "MA",
                  "search_volume": 264,
                  "percentage": 1.81083
                },
                {
                  "country_iso_code": "ZA",
                  "search_volume": 196,
                  "percentage": 1.34444
                },
                {
                  "country_iso_code": "SG",
                  "search_volume": 176,
                  "percentage": 1.20931
                },
                {
                  "country_iso_code": "NG",
                  "search_volume": 160,
                  "percentage": 1.09471
                },
                {
                  "country_iso_code": "GR",
                  "search_volume": 154,
                  "percentage": 1.05936
                },
                {
                  "country_iso_code": "EG",
                  "search_volume": 150,
                  "percentage": 1.03256
                },
                {
                  "country_iso_code": "ES",
                  "search_volume": 115,
                  "percentage": 0.78739
                },
                {
                  "country_iso_code": "DK",
                  "search_volume": 111,
                  "percentage": 0.76174
                },
                {
                  "country_iso_code": "SA",
                  "search_volume": 107,
                  "percentage": 0.73779
                },
                {
                  "country_iso_code": "CA",
                  "search_volume": 104,
                  "percentage": 0.71327
                },
                {
                  "country_iso_code": "NL",
                  "search_volume": 98,
                  "percentage": 0.67507
                },
                {
                  "country_iso_code": "PH",
                  "search_volume": 94,
                  "percentage": 0.64428
                },
                {
                  "country_iso_code": "AU",
                  "search_volume": 83,
                  "percentage": 0.57301
                },
                {
                  "country_iso_code": "PL",
                  "search_volume": 76,
                  "percentage": 0.52626
                },
                {
                  "country_iso_code": "SE",
                  "search_volume": 73,
                  "percentage": 0.5006
                },
                {
                  "country_iso_code": "IT",
                  "search_volume": 70,
                  "percentage": 0.48179
                },
                {
                  "country_iso_code": "KZ",
                  "search_volume": 68,
                  "percentage": 0.47152
                },
                {
                  "country_iso_code": "IR",
                  "search_volume": 66,
                  "percentage": 0.45613
                },
                {
                  "country_iso_code": "CH",
                  "search_volume": 63,
                  "percentage": 0.43389
                },
                {
                  "country_iso_code": "LY",
                  "search_volume": 59,
                  "percentage": 0.40538
                },
                {
                  "country_iso_code": "NO",
                  "search_volume": 59,
                  "percentage": 0.40481
                },
                {
                  "country_iso_code": "BG",
                  "search_volume": 51,
                  "percentage": 0.35236
                },
                {
                  "country_iso_code": "RU",
                  "search_volume": 49,
                  "percentage": 0.33982
                },
                {
                  "country_iso_code": "BR",
                  "search_volume": 48,
                  "percentage": 0.33012
                },
                {
                  "country_iso_code": "DZ",
                  "search_volume": 45,
                  "percentage": 0.31017
                },
                {
                  "country_iso_code": "PA",
                  "search_volume": 41,
                  "percentage": 0.28622
                },
                {
                  "country_iso_code": "RO",
                  "search_volume": 39,
                  "percentage": 0.27026
                },
                {
                  "country_iso_code": "TN",
                  "search_volume": 35,
                  "percentage": 0.24289
                },
                {
                  "country_iso_code": "IL",
                  "search_volume": 34,
                  "percentage": 0.23605
                },
                {
                  "country_iso_code": "AE",
                  "search_volume": 32,
                  "percentage": 0.22236
                },
                {
                  "country_iso_code": "DO",
                  "search_volume": 32,
                  "percentage": 0.22464
                },
                {
                  "country_iso_code": "BW",
                  "search_volume": 32,
                  "percentage": 0.22293
                },
                {
                  "country_iso_code": "LT",
                  "search_volume": 31,
                  "percentage": 0.21666
                },
                {
                  "country_iso_code": "JO",
                  "search_volume": 31,
                  "percentage": 0.21723
                },
                {
                  "country_iso_code": "AR",
                  "search_volume": 29,
                  "percentage": 0.20127
                },
                {
                  "country_iso_code": "SC",
                  "search_volume": 6,
                  "percentage": 0.04333
                },
                {
                  "country_iso_code": null,
                  "search_volume": 3,
                  "percentage": 0.02395
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Each object in the items array covers one keyword:

  • search_volume at the item level is the global search volume, the keyword’s estimated average monthly searches worldwide.
  • country_distribution lists every country where the keyword is searched, ordered by volume. Each entry holds country_iso_code (the two-letter ISO code of the country), search_volume (monthly searches in that country), and percentage (that country’s share of the global figure).

Two practical notes. Match results to your input by the keyword field rather than by position, since items don’t necessarily come back in the order you sent them. You may also see one entry with null in country_iso_code: it holds the small part of the global volume that isn’t tied to a specific country, so keep it when you check totals and skip it when you plot a map.

How to get regional search volume from country shares

The API breaks global volume down by country. For a regional view, whether that’s DACH, the EU, Southeast Asia, or Latin America, add up search_volume or percentage across the countries that make up your region.

Here’s what that looks like with the same request:

  • “keyword research”: India, Bangladesh, Pakistan, Nepal, and Sri Lanka together account for 113,898 of its 168,588 monthly searches, or 67.6% of global demand. For this keyword, South Asia is the main market.
  • “seo tools”: Germany, Austria, and Switzerland add up to 7,788 monthly searches, a 3.6% share, while Vietnam alone brings in 86,305 (39.5%). A team focused on DACH and a team focused on Southeast Asia would plan very differently around this keyword.

You define the regions, so keep a fixed list of countries for each one in your code. That way, regional totals stay comparable from one month to the next.

FAQ

How do I find search volume for keywords for global, worldwide, international, across the globe, or regional scope?
Send your keywords to our Global Search Volume endpoint. One request covers up to 1,000 keywords and returns the worldwide monthly total for each, the volume in every country where it’s searched, and each country’s percentage share. For regional scope, add up the country values for the region you need.

What is global search volume?
Global search volume is the estimated number of times a keyword is searched per month across all countries combined. We calculate it from clickstream data: first, we estimate the keyword’s search volume in each country, then we sum those values to obtain a worldwide figure.

Global vs local search volume API: which one should I use?
Use the global endpoint when you’re deciding where a keyword has demand, and a local one once you know the market. For country-level data, use DataForSEO Search Volume or Google Ads Search Volume. For city-level data, use Google Ads Search Volume with a city as the location.

Is there a worldwide keyword search volume API?
Yes. The Global Search Volume endpoint in our Keyword Data API returns worldwide search volume along with a breakdown by country. Google Ads Search Volume also returns worldwide totals if you leave the location out, but without the split by country.

Why doesn’t global search volume match Google Ads numbers?
The two come from different sources and methods. Global search volume is a clickstream-based estimate for each keyword, while Google Ads can return one combined value for a group of similar keywords. Compare figures from the same source to keep your analysis consistent.

Can I get global search volume for more than 1,000 keywords?
Yes. Split the list into batches of up to 1,000 keywords and send one request per batch. The endpoint accepts up to 10,000 API calls per minute, with no more than 30 requests running at the same time.

To see how your own keyword list spreads across the globe, try for free and run it through the Global Search Volume endpoint.

Was this article helpful?