[{"data":1,"prerenderedAt":982},["ShallowReactive",2],{"learn-nav":3,"learn-surround:\u002Flearn-google-search-console\u002Fapi\u002Fbranded-clicks-by-market":119,"learn-page:\u002Flearn-google-search-console\u002Fapi\u002Fbranded-clicks-by-market":126},[4],{"path":5,"title":6,"children":7,"stem":118,"page":16},"\u002Flearn-google-search-console","Learn GSC",[8,26,51,80,101,110,114],{"path":9,"title":10,"children":11,"stem":25,"page":16},"\u002Flearn-google-search-console\u002Fai-agents","Agents",[12,17,21],{"path":13,"title":14,"stem":15,"page":16},"\u002Flearn-google-search-console\u002Fai-agents\u002Fmcp-server","Check the connection","ai-agents\u002F1.mcp-server",true,{"path":18,"title":19,"stem":20,"page":16},"\u002Flearn-google-search-console\u002Fai-agents\u002Fclaude-code-seo","Claude Code SEO","ai-agents\u002F2.claude-code-seo",{"path":22,"title":23,"stem":24,"page":16},"\u002Flearn-google-search-console\u002Fai-agents\u002Fseo-workflows","SEO workflows","ai-agents\u002F3.seo-workflows","ai-agents\u002Findex",{"path":27,"title":28,"children":29,"stem":50,"page":16},"\u002Flearn-google-search-console\u002Fapi","API",[30,34,38,42,46],{"path":31,"title":32,"stem":33,"page":16},"\u002Flearn-google-search-console\u002Fapi\u002Fquery-builder","Query builder","api\u002F2.query-builder",{"path":35,"title":36,"stem":37,"page":16},"\u002Flearn-google-search-console\u002Fapi\u002Frate-limits","Rate limits","api\u002F3.rate-limits",{"path":39,"title":40,"stem":41,"page":16},"\u002Flearn-google-search-console\u002Fapi\u002Fauthentication","Authentication","api\u002F4.authentication",{"path":43,"title":44,"stem":45,"page":16},"\u002Flearn-google-search-console\u002Fapi\u002Fbranded-clicks-by-market","Branded clicks by market","api\u002Fbranded-clicks-by-market",{"path":47,"title":48,"stem":49,"page":16},"\u002Flearn-google-search-console\u002Fapi\u002Fhourly-search-analytics-api","Hourly data","api\u002Fhourly-search-analytics-api","api\u002Findex",{"path":52,"title":53,"children":54,"stem":79,"page":16},"\u002Flearn-google-search-console\u002Flimits","Limits",[55,59,63,67,71,75],{"path":56,"title":57,"stem":58,"page":16},"\u002Flearn-google-search-console\u002Flimits\u002F16-month-data-retention","Data retention","limits\u002F1.16-month-data-retention",{"path":60,"title":61,"stem":62,"page":16},"\u002Flearn-google-search-console\u002Flimits\u002Fexport-row-limits","Export limits","limits\u002F2.export-row-limits",{"path":64,"title":65,"stem":66,"page":16},"\u002Flearn-google-search-console\u002Flimits\u002Fbigquery-alternative","BigQuery alternative","limits\u002F3.bigquery-alternative",{"path":68,"title":69,"stem":70,"page":16},"\u002Flearn-google-search-console\u002Flimits\u002F1000-row-limit","1,000-row limit","limits\u002F4.1000-row-limit",{"path":72,"title":73,"stem":74,"page":16},"\u002Flearn-google-search-console\u002Flimits\u002Fdata-delay","Data delay","limits\u002F5.data-delay",{"path":76,"title":77,"stem":78,"page":16},"\u002Flearn-google-search-console\u002Flimits\u002Fgsc-vs-ga4","GSC vs. GA4","limits\u002F6.gsc-vs-ga4","limits\u002Findex",{"path":81,"title":82,"children":83,"stem":100,"page":16},"\u002Flearn-google-search-console\u002Fperformance","Performance reports",[84,88,92,96],{"path":85,"title":86,"stem":87,"page":16},"\u002Flearn-google-search-console\u002Fperformance\u002Fai-powered-configuration","AI-powered configuration","performance\u002Fai-powered-configuration",{"path":89,"title":90,"stem":91,"page":16},"\u002Flearn-google-search-console\u002Fperformance\u002Fbranded-queries-filter","Branded queries","performance\u002Fbranded-queries-filter",{"path":93,"title":94,"stem":95,"page":16},"\u002Flearn-google-search-console\u002Fperformance\u002Fcustom-annotations","Annotations","performance\u002Fcustom-annotations",{"path":97,"title":98,"stem":99,"page":16},"\u002Flearn-google-search-console\u002Fperformance\u002Fgenerative-ai-performance-reports","Generative AI reports","performance\u002Fgenerative-ai-performance-reports","performance\u002Findex",{"path":102,"title":103,"children":104,"stem":109,"page":16},"\u002Flearn-google-search-console\u002Fresearch","Research",[105],{"path":106,"title":107,"stem":108,"page":16},"\u002Flearn-google-search-console\u002Fresearch\u002Fgsc-data-loss-study","Query gaps research","research\u002F1.gsc-data-loss-study","research\u002Findex",{"path":111,"title":112,"stem":113,"page":16},"\u002Flearn-google-search-console\u002Fsocial-platform-properties","Social accounts","social-platform-properties",{"path":115,"title":116,"stem":117,"page":16},"\u002Flearn-google-search-console\u002Fweekly-monthly-views","Weekly and monthly views","weekly-monthly-views","index",[120,123],{"path":39,"title":40,"description":121,"navigation":122},"Set up read-only Google OAuth access, confirm property permissions, and diagnose expired tokens or redirect errors.",{"title":40},{"path":47,"title":48,"description":124,"navigation":125},"Request hourly Search Console data with hour and hourly_all. Preserve timestamp offsets and inspect incomplete-hour metadata before comparing recent traffic.",{"title":48},{"title":127,"description":128,"publishedAt":129,"updatedAt":129,"ogImage":130,"body":134,"id":976,"path":43,"stem":45,"extension":977,"navigation":978,"seo":979,"_source":980,"sitemap":981},"Branded search clicks by market with the Search Console API","Use one Search Analytics request to compare branded clicks across countries. Read the returned rows and handle a missing country without assuming zero clicks.","2026-11-21",{"component":131,"props":132},"Article",{"title":44,"description":133},"Compare branded Search Console clicks across countries",{"toc":135,"nodes":146,"frontmatter":966,"meta":970},{"links":136,"title":144,"searchDepth":145,"depth":145},[137,141],{"id":138,"text":139,"depth":140},"request-branded-clicks-for-three-countries","Request branded clicks for three countries",2,{"id":142,"text":143,"depth":140},"read-the-country-rows","Read the country rows","",3,[147,157,160,163,175,191,198,852,859,892,903,905,930,945,956],[148,149,150,151,156],"p",{},"If you report on several markets, you can compare branded Google Search clicks across countries in one Search Analytics request. Google ",[152,153,155],"a",{"href":154},"https:\u002F\u002Fdevelopers.google.com\u002Fsearch\u002Fblog\u002F2026\u002F11\u002Fsearch-analytics-api-update","added brand labels and filters for country lists"," to the API in November 2026.",[148,158,159],{},"Start with a complete week. In this example, you’ll count branded clicks from the United States, Canada, and the United Kingdom.",[161,162,139],"h2",{"id":138},[148,164,165,166,170,171,174],{},"Use an eligible top-level Search Console property with enough query and impression data. Google documents branded API data from 21 February 2026. Check the ",[152,167,169],{"href":168},"https:\u002F\u002Fdevelopers.google.com\u002Fwebmaster-tools\u002Fv1\u002Fsearchanalytics\u002Fquery","API eligibility rules"," and the ",[152,172,173],{"href":89},"branded queries filter"," if you’re unsure whether your property qualifies.",[148,176,177,178,182,183,186,187,190],{},"You need Node.js 24 or later and a Google OAuth access token with the ",[179,180,181],"code",{},"webmasters.readonly"," scope. Set ",[179,184,185],{},"GOOGLE_ACCESS_TOKEN"," in your shell before running the script. Follow the ",[152,188,189],{"href":39},"authentication guide"," to get a token and confirm property access.",[148,192,193,194,197],{},"Save the script as ",[179,195,196],{},"branded-clicks.mts",".",[199,200,203],"pre",{"language":201,"class":202},"ts","rangi shiki shj-lang-ts",[179,204,206,226,227,226,229,226,276,226,290,226,292,226,324,226,339,226,354,226,359,226,361,226,376,226,399,226,403,226,414,226,421,226,438,226,448,226,455,226,472,226,477,226,482,226,495,226,505,226,519,226,528,226,538,226,575,226,616,226,624,226,632,226,638,226,642,226,644,226,658,226,688,226,690,226,724,226,756,226,760,226,762,226,780,226,794,226,799],{"class":205},"language-ts",[207,208,211,216,217,220,221],"span",{"class":209,"style":210},"line","display: inline",[207,212,215],{"class":213,"style":214},"shj-syn-kwd shj-kwd","--shiki-light:#cf222e;--shiki-default:#cf222e;color:#cf222e;--shiki-dark:#ff7b72","import"," process ",[207,218,219],{"class":213,"style":214},"from"," ",[207,222,225],{"class":223,"style":224},"shj-syn-str shj-str","--shiki-light:#0a3069;--shiki-default:#0a3069;color:#0a3069;--shiki-dark:#a5d6ff","'node:process'","\n",[207,228],{"class":209,"style":210},[207,230,231,220,234,239,240,244,245,247,248,220,251,254,255,257,258,260,265,268,273],{"class":209,"style":210},[207,232,233],{"class":213,"style":214},"const",[207,235,238],{"class":236,"style":237},"shj-syn-bracket shj-bracket","--shiki-light:#57606a;--shiki-default:#57606a;color:#57606a;--shiki-dark:#8b949e","[","property",[207,241,243],{"class":242,"style":214},"shj-syn-oper shj-oper",","," startDate",[207,246,243],{"class":242,"style":214}," endDate",[207,249,250],{"class":236,"style":237},"]",[207,252,253],{"class":242,"style":214},"="," process",[207,256,197],{"class":242,"style":214},"argv",[207,259,197],{"class":242,"style":214},[207,261,264],{"class":262,"style":263},"shj-syn-func shj-func","--shiki-light:#8250df;--shiki-default:#8250df;color:#8250df;--shiki-dark:#d2a8ff","slice",[207,266,267],{"class":236,"style":237},"(",[207,269,272],{"class":270,"style":271},"shj-syn-num shj-num","--shiki-light:#0550ae;--shiki-default:#0550ae;color:#0550ae;--shiki-dark:#79c0ff","2",[207,274,275],{"class":236,"style":237},")",[207,277,278,280,281,254,283,285,286,288],{"class":209,"style":210},[207,279,233],{"class":213,"style":214}," token ",[207,282,253],{"class":242,"style":214},[207,284,197],{"class":242,"style":214},"env",[207,287,197],{"class":242,"style":214},[207,289,185],{"class":270,"style":271},[207,291],{"class":209,"style":210},[207,293,294,220,297,299,302,303,220,306,308,309,220,311,313,314,220,316,318,319,220,321],{"class":209,"style":210},[207,295,296],{"class":213,"style":214},"if",[207,298,267],{"class":236,"style":237},[207,300,301],{"class":242,"style":214},"!","property ",[207,304,305],{"class":242,"style":214},"||",[207,307,301],{"class":242,"style":214},"startDate ",[207,310,305],{"class":242,"style":214},[207,312,301],{"class":242,"style":214},"endDate ",[207,315,305],{"class":242,"style":214},[207,317,301],{"class":242,"style":214},"token",[207,320,275],{"class":236,"style":237},[207,322,323],{"class":236,"style":237},"{",[207,325,326,327,329,332,334,337],{"class":209,"style":210},"  console",[207,328,197],{"class":242,"style":214},[207,330,331],{"class":262,"style":263},"error",[207,333,267],{"class":236,"style":237},[207,335,336],{"class":223,"style":224},"'Set GOOGLE_ACCESS_TOKEN and pass a property, start date, and end date.'",[207,338,275],{"class":236,"style":237},[207,340,341,342,344,347,349,352],{"class":209,"style":210},"  process",[207,343,197],{"class":242,"style":214},[207,345,346],{"class":262,"style":263},"exit",[207,348,267],{"class":236,"style":237},[207,350,351],{"class":270,"style":271},"1",[207,353,275],{"class":236,"style":237},[207,355,356],{"class":209,"style":210},[207,357,358],{"class":236,"style":237},"}",[207,360],{"class":209,"style":210},[207,362,363,365,366,220,368,220,371,374],{"class":209,"style":210},[207,364,233],{"class":213,"style":214}," response ",[207,367,253],{"class":242,"style":214},[207,369,370],{"class":213,"style":214},"await",[207,372,373],{"class":262,"style":263},"fetch",[207,375,267],{"class":236,"style":237},[207,377,378,379,382,385,388,239,390,392,394,397],{"class":209,"style":210},"  ",[207,380,381],{"class":223,"style":224},"`https:\u002F\u002Fwww.googleapis.com\u002Fwebmasters\u002Fv3\u002Fsites\u002F",[207,383,384],{"class":213,"style":214},"${",[207,386,387],{"class":262,"style":263},"encodeURIComponent",[207,389,267],{"class":236,"style":237},[207,391,275],{"class":236,"style":237},[207,393,358],{"class":213,"style":214},[207,395,396],{"class":223,"style":224},"\u002FsearchAnalytics\u002Fquery`",[207,398,243],{"class":242,"style":214},[207,400,378,401],{"class":209,"style":210},[207,402,323],{"class":236,"style":237},[207,404,405,406,220,409,412],{"class":209,"style":210},"    method",[207,407,408],{"class":242,"style":214},":",[207,410,411],{"class":223,"style":224},"'POST'",[207,413,243],{"class":242,"style":214},[207,415,416,417,220,419],{"class":209,"style":210},"    headers",[207,418,408],{"class":242,"style":214},[207,420,323],{"class":236,"style":237},[207,422,423,424,220,426,429,318,431,433,436],{"class":209,"style":210},"      Authorization",[207,425,408],{"class":242,"style":214},[207,427,428],{"class":223,"style":224},"`Bearer ",[207,430,384],{"class":213,"style":214},[207,432,358],{"class":213,"style":214},[207,434,435],{"class":223,"style":224},"`",[207,437,243],{"class":242,"style":214},[207,439,440,441,220,443,446],{"class":209,"style":210},"      'Content-Type'",[207,442,408],{"class":242,"style":214},[207,444,445],{"class":223,"style":224},"'application\u002Fjson'",[207,447,243],{"class":242,"style":214},[207,449,450,451,453],{"class":209,"style":210},"    ",[207,452,358],{"class":236,"style":237},[207,454,243],{"class":242,"style":214},[207,456,457,458,220,460,463,465,468,470],{"class":209,"style":210},"    body",[207,459,408],{"class":242,"style":214},[207,461,462],{"class":270,"style":271},"JSON",[207,464,197],{"class":242,"style":214},[207,466,467],{"class":262,"style":263},"stringify",[207,469,267],{"class":236,"style":237},[207,471,323],{"class":236,"style":237},[207,473,474,475],{"class":209,"style":210},"      startDate",[207,476,243],{"class":242,"style":214},[207,478,479,480],{"class":209,"style":210},"      endDate",[207,481,243],{"class":242,"style":214},[207,483,484,485,488,220,490,493],{"class":209,"style":210},"      ",[207,486,487],{"class":213,"style":214},"type",[207,489,408],{"class":242,"style":214},[207,491,492],{"class":223,"style":224},"'web'",[207,494,243],{"class":242,"style":214},[207,496,497,498,220,500,503],{"class":209,"style":210},"      dataState",[207,499,408],{"class":242,"style":214},[207,501,502],{"class":223,"style":224},"'final'",[207,504,243],{"class":242,"style":214},[207,506,507,508,220,510,512,515,517],{"class":209,"style":210},"      dimensions",[207,509,408],{"class":242,"style":214},[207,511,238],{"class":236,"style":237},[207,513,514],{"class":223,"style":224},"'country'",[207,516,250],{"class":236,"style":237},[207,518,243],{"class":242,"style":214},[207,520,521,522,220,524,526],{"class":209,"style":210},"      dimensionFilterGroups",[207,523,408],{"class":242,"style":214},[207,525,238],{"class":236,"style":237},[207,527,323],{"class":236,"style":237},[207,529,530,531,220,533,536],{"class":209,"style":210},"        groupType",[207,532,408],{"class":242,"style":214},[207,534,535],{"class":223,"style":224},"'and'",[207,537,243],{"class":242,"style":214},[207,539,540,541,220,543,545,547,548,220,550,553,555,556,220,558,561,563,564,220,566,220,569,571,573],{"class":209,"style":210},"        filters",[207,542,408],{"class":242,"style":214},[207,544,238],{"class":236,"style":237},[207,546,323],{"class":236,"style":237}," dimension",[207,549,408],{"class":242,"style":214},[207,551,552],{"class":223,"style":224},"'brandedClassification'",[207,554,243],{"class":242,"style":214}," operator",[207,557,408],{"class":242,"style":214},[207,559,560],{"class":223,"style":224},"'equals'",[207,562,243],{"class":242,"style":214}," expression",[207,565,408],{"class":242,"style":214},[207,567,568],{"class":223,"style":224},"'BRANDED'",[207,570,358],{"class":236,"style":237},[207,572,250],{"class":236,"style":237},[207,574,243],{"class":242,"style":214},[207,576,577,578,220,580,582,547,584,220,586,588,590,591,220,593,595,598,220,600,603,220,605,608,220,610,612,614],{"class":209,"style":210},"        filterLists",[207,579,408],{"class":242,"style":214},[207,581,238],{"class":236,"style":237},[207,583,323],{"class":236,"style":237},[207,585,408],{"class":242,"style":214},[207,587,514],{"class":223,"style":224},[207,589,243],{"class":242,"style":214}," expressions",[207,592,408],{"class":242,"style":214},[207,594,238],{"class":236,"style":237},[207,596,597],{"class":223,"style":224},"'usa'",[207,599,243],{"class":242,"style":214},[207,601,602],{"class":223,"style":224},"'can'",[207,604,243],{"class":242,"style":214},[207,606,607],{"class":223,"style":224},"'gbr'",[207,609,250],{"class":236,"style":237},[207,611,358],{"class":236,"style":237},[207,613,250],{"class":236,"style":237},[207,615,243],{"class":242,"style":214},[207,617,484,618,620,622],{"class":209,"style":210},[207,619,358],{"class":236,"style":237},[207,621,250],{"class":236,"style":237},[207,623,243],{"class":242,"style":214},[207,625,450,626,628,630],{"class":209,"style":210},[207,627,358],{"class":236,"style":237},[207,629,275],{"class":236,"style":237},[207,631,243],{"class":242,"style":214},[207,633,378,634,636],{"class":209,"style":210},[207,635,358],{"class":236,"style":237},[207,637,243],{"class":242,"style":214},[207,639,640],{"class":209,"style":210},[207,641,275],{"class":236,"style":237},[207,643],{"class":209,"style":210},[207,645,646,220,648,650,652,653,655,656],{"class":209,"style":210},[207,647,296],{"class":213,"style":214},[207,649,267],{"class":236,"style":237},[207,651,301],{"class":242,"style":214},"response",[207,654,197],{"class":242,"style":214},"ok",[207,657,275],{"class":236,"style":237},[207,659,378,660,220,663,220,666,671,673,676,652,678,680,681,683,686],{"class":209,"style":210},[207,661,662],{"class":213,"style":214},"throw",[207,664,665],{"class":213,"style":214},"new",[207,667,670],{"class":668,"style":669},"shj-syn-class shj-class","--shiki-light:#953800;--shiki-default:#953800;color:#953800;--shiki-dark:#ffa657","Error",[207,672,267],{"class":236,"style":237},[207,674,675],{"class":223,"style":224},"`Search Console returned HTTP ",[207,677,384],{"class":213,"style":214},[207,679,197],{"class":242,"style":214},"status",[207,682,358],{"class":213,"style":214},[207,684,685],{"class":223,"style":224},".`",[207,687,275],{"class":236,"style":237},[207,689],{"class":209,"style":210},[207,691,692,220,694,696,697,220,699,701,220,703,220,705,220,707,709,710,712,715,717,220,719,220,722],{"class":209,"style":210},[207,693,233],{"class":213,"style":214},[207,695,323],{"class":236,"style":237}," rows ",[207,698,253],{"class":242,"style":214},[207,700,238],{"class":236,"style":237},[207,702,250],{"class":236,"style":237},[207,704,358],{"class":236,"style":237},[207,706,253],{"class":242,"style":214},[207,708,370],{"class":213,"style":214}," response",[207,711,197],{"class":242,"style":214},[207,713,714],{"class":262,"style":263},"json",[207,716,267],{"class":236,"style":237},[207,718,275],{"class":236,"style":237},[207,720,721],{"class":213,"style":214},"as",[207,723,323],{"class":236,"style":237},[207,725,726,727,220,730,732,733,220,735,737,738,742,744,746,747,220,750,752,754],{"class":209,"style":210},"  rows",[207,728,729],{"class":242,"style":214},"?:",[207,731,323],{"class":236,"style":237}," keys",[207,734,408],{"class":242,"style":214},[207,736,238],{"class":236,"style":237},"country",[207,739,741],{"class":740,"style":271},"shj-syn-type shj-type",": string",[207,743,250],{"class":236,"style":237},[207,745,243],{"class":242,"style":214}," clicks",[207,748,749],{"class":740,"style":271},": number",[207,751,358],{"class":236,"style":237},[207,753,238],{"class":236,"style":237},[207,755,250],{"class":236,"style":237},[207,757,758],{"class":209,"style":210},[207,759,358],{"class":236,"style":237},[207,761],{"class":209,"style":210},[207,763,764,220,766,768,769,771,772,220,775,778],{"class":209,"style":210},[207,765,296],{"class":213,"style":214},[207,767,267],{"class":236,"style":237},"rows",[207,770,197],{"class":242,"style":214},"length ",[207,773,774],{"class":242,"style":214},"===",[207,776,777],{"class":270,"style":271},"0",[207,779,275],{"class":236,"style":237},[207,781,326,782,784,787,789,792],{"class":209,"style":210},[207,783,197],{"class":242,"style":214},[207,785,786],{"class":262,"style":263},"log",[207,788,267],{"class":236,"style":237},[207,790,791],{"class":223,"style":224},"'Search Console returned no rows for this request.'",[207,793,275],{"class":236,"style":237},[207,795,796],{"class":209,"style":210},[207,797,798],{"class":213,"style":214},"else",[207,800,326,801,803,806,768,808,810,813,815,816,220,819,821,823,824,826,827,829,830,832,834,836,838,839,826,841,843,844,846,848,850],{"class":209,"style":210},[207,802,197],{"class":242,"style":214},[207,804,805],{"class":262,"style":263},"table",[207,807,267],{"class":236,"style":237},[207,809,197],{"class":242,"style":214},[207,811,812],{"class":262,"style":263},"map",[207,814,267],{"class":236,"style":237},"row ",[207,817,818],{"class":213,"style":214},"=>",[207,820,267],{"class":236,"style":237},[207,822,323],{"class":236,"style":237}," country",[207,825,408],{"class":242,"style":214}," row",[207,828,197],{"class":242,"style":214},"keys",[207,831,238],{"class":236,"style":237},[207,833,777],{"class":270,"style":271},[207,835,250],{"class":236,"style":237},[207,837,243],{"class":242,"style":214}," brandedClicks",[207,840,408],{"class":242,"style":214},[207,842,197],{"class":242,"style":214},"clicks ",[207,845,358],{"class":236,"style":237},[207,847,275],{"class":236,"style":237},[207,849,275],{"class":236,"style":237},[207,851,275],{"class":236,"style":237},[148,853,854,855,858],{},"Replace ",[179,856,857],{},"sc-domain:example.com"," with your property identifier. For a URL-prefix property, pass the full prefix as Search Console shows it. The script encodes either format in the request URL.",[199,860,863],{"language":861,"class":862},"bash","rangi shiki shj-lang-bash",[179,864,866],{"class":865},"language-bash",[207,867,868,871,872,220,875,878,879,878,882,220,885,878,887,878,889],{"class":209,"style":210},[207,869,870],{"class":262,"style":263},"node"," branded-clicks.mts ",[207,873,874],{"class":223,"style":224},"'sc-domain:example.com'",[207,876,877],{"class":270,"style":271},"2026","-",[207,880,881],{"class":270,"style":271},"11",[207,883,884],{"class":270,"style":271},"02",[207,886,877],{"class":270,"style":271},[207,888,881],{"class":270,"style":271},[207,890,891],{"class":270,"style":271},"08",[148,893,894,895,898,899,902],{},"Search Console includes both dates in Pacific Time. ",[179,896,897],{},"dataState: 'final'"," requests finalized data. If your date range includes recent days, ",[152,900,901],{"href":72},"check when they become available"," before comparing countries.",[161,904,143],{"id":142},[148,906,907,910,911,914,915,918,919,922,923,926,927,197],{},[179,908,909],{},"filterLists"," keeps rows from any of the three countries. The brand filter also has to match. ",[179,912,913],{},"dimensions: ['country']"," keeps the counts separate, so ",[179,916,917],{},"keys[0]"," gives the country code for each returned row. Leave out ",[179,920,921],{},"query"," filters when you group or filter by ",[179,924,925],{},"brandedClassification",". See the ",[152,928,929],{"href":168},"request and response reference",[148,931,932,933,936,937,940,941,944],{},"Suppose the script prints 420 clicks for ",[179,934,935],{},"usa"," and 95 for ",[179,938,939],{},"can",". Those example counts cover the same week and search type. If ",[179,942,943],{},"gbr"," is missing, leave its value blank. The API can omit rows, and an ineligible property can return no rows at all.",[148,946,947,948,951,952,955],{},"To compare the same countries across weeks, change the dates and keep the property, search type, and country list fixed. To report non-branded clicks for the same week, change ",[179,949,950],{},"BRANDED"," to ",[179,953,954],{},"NON_BRANDED"," and run the request again.",[148,957,958,959,962,963,197],{},"To count all clicks from Google Lens, Circle to Search, and image uploads in these markets, send a separate request. Keep the country list, remove the brand filter, and set ",[179,960,961],{},"type: 'webMultimodal'",". See ",[152,964,965],{"href":154},"Google’s multimodal reporting update",{"publishedAt":129,"updatedAt":129,"title":127,"description":128,"navigation":967,"ogImage":968},{"title":44},{"component":131,"props":969},{"title":44,"description":133},{"description":971,"toc":972},"If you report on several markets, you can compare branded Google Search clicks across countries in one Search Analytics request. Google added brand labels and filters for country lists to the API in November 2026.",{"title":144,"searchDepth":145,"depth":145,"links":973},[974,975],{"id":138,"depth":140,"text":139},{"id":142,"depth":140,"text":143},"learnGsc\u002Fapi\u002Fbranded-clicks-by-market.md","md",{"title":44},{"title":127,"description":128},"\u002Fopt\u002Factions-runner\u002F_work\u002Fgscdump.com\u002Fgscdump.com\u002Fcontent\u002Flearn-google-search-console\u002Fapi\u002Fbranded-clicks-by-market.md",{"loc":43,"lastmod":129},1795365528037]