{"id":13553,"date":"2022-04-29T15:58:38","date_gmt":"2022-04-29T15:58:38","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=13553"},"modified":"2024-11-11T17:32:13","modified_gmt":"2024-11-11T17:32:13","slug":"app_data-google-locations","status":"publish","type":"page","link":"https:\/\/docs.dataforapps.com\/v3\/app_data-google-locations\/","title":{"rendered":"app_data\/google\/locations"},"content":{"rendered":"

[vc_row][vc_column][vc_column_text]<\/p>\n

List of Google Locations for App Data API<\/h2>\n

 
\nBy calling this endpoint you will receive the list of Google locations supported in App Data API.<\/p>\n

You can also download the full list of supported locations<\/a> in the CSV format (last updated 2024-11-05).<\/p>\n

Note:<\/strong> All locations in Russia and Belarus are not supported across all DataForApps services due to the invasion of Ukraine.<\/h3>\n

 
\n[\/vc_column_text]\n

\n

Instead of \u2018login\u2019 and \u2018password\u2019 use your credentials from https:\/\/app.dataforapps.com\/api-dashboard<\/p>\n <\/blockquote>\n 

\n            <\/p>\n
\r\n# Instead of 'login' and 'password' use your credentials from https:\/\/app.dataforapps.com\/api-dashboard \\\r\nlogin=\"login\" \\\r\npassword=\"password\" \\\r\ncred=\"$(printf ${login}:${password} | base64)\" \\\r\ncurl --location --request GET \"https:\/\/api.dataforapps.com\/v3\/app_data\/google\/locations\" \\\r\n--header \"Authorization: Basic ${cred}\"  \\\r\n--header \"Content-Type: application\/json\" \\\r\n<\/pre>\n
\n        <\/pre>\n        
<\/p>\n
<?php\r\n\/\/ You can download this file from here https:\/\/cdn.dataforapps.com\/v3\/examples\/php\/php_RestClient.zip\r\nrequire('RestClient.php');\r\n$api_url = 'https:\/\/api.dataforapps.com\/';\r\ntry {\r\n\t\/\/ Instead of 'login' and 'password' use your credentials from https:\/\/app.dataforapps.com\/api-dashboard\r\n\t$client = new RestClient($api_url, null, 'login', 'password');\r\n} catch (RestClientException $e) {\r\n\techo \"n\";\r\n\tprint \"HTTP code: {$e->getHttpCode()}n\";\r\n\tprint \"Error code: {$e->getCode()}n\";\r\n\tprint \"Message: {$e->getMessage()}n\";\r\n\tprint  $e->getTraceAsString();\r\n\techo \"n\";\r\n\texit();\r\n}\r\ntry {\r\n\t\/\/ using this method you can get a list of locations\r\n\t\/\/ GET \/v3\/app_data\/google\/locations\r\n\t\/\/ in addition to 'google' you can also set other search engine\r\n\t\/\/ the full list of possible parameters is available in documentation\r\n\t$result = $client->get('\/v3\/app_data\/google\/locations');\r\n\tprint_r($result);\r\n\t\/\/ do something with result\r\n} catch (RestClientException $e) {\r\n\techo \"n\";\r\n\tprint \"HTTP code: {$e->getHttpCode()}n\";\r\n\tprint \"Error code: {$e->getCode()}n\";\r\n\tprint \"Message: {$e->getMessage()}n\";\r\n\tprint  $e->getTraceAsString();\r\n\techo \"n\";\r\n}\r\n$client = null;\r\n?><\/pre>\n
<\/pre>\n        
\n            <\/p>\n
from client import RestClient\r\n# You can download this file from here https:\/\/cdn.dataforapps.com\/v3\/examples\/python\/python_Client.zip\r\nclient = RestClient(\"login\", \"password\")\r\n# using this method you can get a list of locations\r\n# GET \/v3\/app_data\/google\/locations\r\n# in addition to 'google' you can also set other search engine\r\n# the full list of possible parameters is available in documentation\r\nresponse = client.get(\"\/v3\/app_data\/google\/locations\")\r\n# you can find the full list of the response codes here https:\/\/docs.dataforapps.com\/v3\/appendix\/errors\r\nif response[\"status_code\"] == 20000:\r\n    print(response)\r\n    # do something with result\r\nelse:\r\n    print(\"error. Code: %d Message: %s\" % (response[\"status_code\"], response[\"status_message\"]))<\/pre>\n
\n        <\/pre>\n        
\n            <\/p>\n
\r\n\r\nconst axios = require('axios');\r\n\r\naxios({\r\n    method: 'get',\r\n    url: 'https:\/\/api.dataforapps.com\/v3\/app_data\/google\/locations',\r\n    auth: {\r\n        username: 'login',\r\n        password: 'password'\r\n    },\r\n    headers: {\r\n        'content-type': 'application\/json'\r\n    }\r\n}).then(function (response) {\r\n    var result = response['data']['tasks'][0]['result'];\r\n    \/\/ Result data\r\n    console.log(result);\r\n}).catch(function (error) {\r\n    console.log(error);\r\n});\r\n<\/pre>\n
\n        <\/pre>\n        
\n            <\/p>\n
using Newtonsoft.Json;\r\nusing System;\r\nusing System.Net.Http;\r\nusing System.Net.Http.Headers;\r\nusing System.Text;\r\nusing System.Threading.Tasks;\r\n\r\nnamespace DataForSeoDemos\r\n{\r\n    public static partial class Demos\r\n    {\r\n        public static async Task app_data_locations()\r\n        {\r\n            var httpClient = new HttpClient\r\n            {\r\n                BaseAddress = new Uri(\"https:\/\/api.dataforapps.com\/\"),\r\n                \/\/ Instead of 'login' and 'password' use your credentials from https:\/\/app.dataforapps.com\/api-dashboard\r\n                DefaultRequestHeaders = { Authorization = new AuthenticationHeaderValue(\"Basic\", Convert.ToBase64String(Encoding.ASCII.GetBytes(\"login:password\"))) }\r\n            };\r\n            \/\/ using this method you can get a list of locations\r\n            \/\/ GET \/v3\/app_data\/google\/locations\r\n            \/\/ in addition to 'google' you can also set other search engine\r\n            \/\/ the full list of possible parameters is available in documentation\r\n            var response = await httpClient.GetAsync(\"\/v3\/app_data\/google\/locations\");\r\n            var result = JsonConvert.DeserializeObject<dynamic>(await response.Content.ReadAsStringAsync());\r\n            \/\/ you can find the full list of the response codes here https:\/\/docs.dataforapps.com\/v3\/appendix\/errors\r\n            if (result.status_code == 20000)\r\n            {\r\n                \/\/ do something with result\r\n                Console.WriteLine(result);\r\n            }\r\n            else\r\n                Console.WriteLine($\"error. Code: {result.status_code} Message: {result.status_message}\");\r\n        }\r\n    }\r\n}\r\n<\/pre>\n
\n        <\/pre>\n        
\n            
The above command returns JSON structured like this:<\/p>\n        <\/blockquote>\n        
<\/p>\n
{\r\n  \"version\": \"0.1.20220420\",\r\n  \"status_code\": 20000,\r\n  \"status_message\": \"Ok.\",\r\n  \"time\": \"0.4267 sec.\",\r\n  \"cost\": 0,\r\n  \"tasks_count\": 1,\r\n  \"tasks_error\": 0,\r\n  \"tasks\": [\r\n    {\r\n      \"id\": \"04211826-2806-0434-0000-2df1073ffaa3\",\r\n      \"status_code\": 20000,\r\n      \"status_message\": \"Ok.\",\r\n      \"time\": \"0.3696 sec.\",\r\n      \"cost\": 0,\r\n      \"result_count\": 117315,\r\n      \"path\": [\r\n        \"v3\",\r\n        \"app_data\",\r\n        \"google\",\r\n        \"locations\"\r\n      ],\r\n      \"data\": {\r\n        \"api\": \"app_data\",\r\n        \"function\": \"locations\",\r\n        \"se\": \"google\"\r\n      },\r\n      \"result\": [\r\n        {\r\n          \"location_code\": 2036,\r\n          \"location_name\": \"Australia\",\r\n          \"location_name_parent\": null,\r\n          \"country_iso_code\": \"AU\",\r\n          \"location_type\": \"Country\"\r\n        },\r\n        {\r\n          \"location_code\": 2124,\r\n          \"location_name\": \"Canada\",\r\n          \"location_name_parent\": null,\r\n          \"country_iso_code\": \"CA\",\r\n          \"location_type\": \"Country\"\r\n        },\r\n        {\r\n          \"location_code\": 2250,\r\n          \"location_name\": \"France\",\r\n          \"location_name_parent\": null,\r\n          \"country_iso_code\": \"FR\",\r\n          \"location_type\": \"Country\"\r\n        }\r\n      ]\r\n    }\r\n  ]\r\n}<\/pre>\n
<\/pre>