Country and State list
Retrieve full list of country and state. You can use id in performing google trend search request.
Requires authentication
Get a full list of country and state
GET https://api.serphouse.com/trends/country/list
Headers
Name
Type
Description
Authorization
String
Bearer <YOUR_API_KEY>
{
"status": "success",
"msg": "Completed",
"results": {
"children": [
{
"children": [
{
"name": "Badakhshan",
"id": "AF-BDS"
},
{
"name": "Badghis",
"id": "AF-BDG"
},
{
"name": "Baghlan",
"id": "AF-BGL"
},
{
"name": "Balkh",
"id": "AF-BAL"
},
{
"name": "Bamiyan",
"id": "AF-BAM"
},
{
"name": "Daykundi",
"id": "AF-DAY"
},
{
"name": "Farah",
"id": "AF-FRA"
},
{
"name": "Faryab",
"id": "AF-FYB"
},
{
"name": "Ghazni",
"id": "AF-GHA"
},
{
"name": "Ghor",
"id": "AF-GHO"
},
{
"name": "Helmand",
"id": "AF-HEL"
},
{
"name": "Herat",
"id": "AF-HER"
},
{
"name": "Jowzjan",
"id": "AF-JOW"
},
{
"name": "Kabul",
"id": "AF-KAB"
},
{
"name": "Kandahar",
"id": "AF-KAN"
},
{
"name": "Kapisa",
"id": "AF-KAP"
},
{
"name": "Khost",
"id": "AF-KHO"
},
{
"name": "Kunar",
"id": "AF-KNR"
},
{
"name": "Kunduz",
"id": "AF-KDZ"
},
{
"name": "Laghman",
"id": "AF-LAG"
},
{
"name": "Logar",
"id": "AF-LOG"
},
{
"name": "Nangarhar",
"id": "AF-NAN"
},
{
"name": "Nimruz",
"id": "AF-NIM"
},
{
"name": "Nuristan",
"id": "AF-NUR"
},
{
"name": "Oruzgan",
"id": "AF-URU"
},
{
"name": "Paktia",
"id": "AF-PIA"
},
{
"name": "Paktika",
"id": "AF-PKA"
},
{
"name": "Panjshir",
"id": "AF-PAN"
},
{
"name": "Parvan",
"id": "AF-PAR"
},
{
"name": "Samangan",
"id": "AF-SAM"
},
{
"name": "Sare Pol",
"id": "AF-SAR"
},
{
"name": "Takhar",
"id": "AF-TAK"
},
{
"name": "Wardak",
"id": "AF-WAR"
},
{
"name": "Zabul",
"id": "AF-ZAB"
}
],
"name": "Afghanistan",
"id": "AF"
},
{
"name": "Åland Islands",
"id": "AX"
},
{
"children": [
{
"name": "Berat",
"id": "AL-01"
},
{
"name": "Dibër County",
"id": "AL-09"
},
{
"name": "Durrës",
"id": "AL-02"
},
{
"name": "Elbasan",
"id": "AL-03"
},
{
"name": "Fier",
"id": "AL-04"
},
{
"name": "Gjirokastra",
"id": "AL-05"
},
{
"name": "Korca",
"id": "AL-06"
},
{
"name": "Kukës County",
"id": "AL-07"
},
{
"name": "Lezhë County",
"id": "AL-08"
},
{
"name": "Shkodër County",
"id": "AL-10"
},
{
"name": "Tirana",
"id": "AL-11"
},
{
"name": "Vlora",
"id": "AL-12"
}
],
"name": "Albania",
"id": "AL"
},
{
"children": [
{
"name": "Adrar Province",
"id": "DZ-01"
},
{
"name": "Aïn Defla Province",
"id": "DZ-44"
},
{
"name": "Aïn Témouchent Province",
"id": "DZ-46"
},
{
"name": "Algiers Province",
"id": "DZ-16"
},
{
"name": "Annaba Province",
"id": "DZ-23"
},
{
"name": "Batna Province",
"id": "DZ-05"
},
{
"name": "Béchar",
"id": "DZ-08"
},
{
"name": "Béjaïa",
"id": "DZ-06"
},
{
"name": "Biskra",
"id": "DZ-07"
},
{
"name": "Blida Province",
"id": "DZ-09"
},
{
"name": "Bordj Bou Arreridj",
"id": "DZ-34"
},
{
"name": "Bouïra Province",
"id": "DZ-10"
},
{
"name": "Boumerdès Province",
"id": "DZ-35"
},
{
"name": "Chlef Province",
"id": "DZ-02"
},
{
"name": "Constantine",
"id": "DZ-25"
},
{
"name": "Djelfa Province",
"id": "DZ-17"
},
{
"name": "El Bayadh Province",
"id": "DZ-32"
},
{
"name": "El Oued Province",
"id": "DZ-39"
},
{
"name": "El Taref Province",
"id": "DZ-36"
},
{
"name": "Ghardaia Province",
"id": "DZ-47"
},
{
"name": "Guelma Province",
"id": "DZ-24"
},
{
"name": "Illizi Province",
"id": "DZ-33"
},
{
"name": "Jijel Province",
"id": "DZ-18"
},
{
"name": "Khenchela Province",
"id": "DZ-40"
},
{
"name": "Laghouat Province",
"id": "DZ-03"
},
{
"name": "M'Sila Province",
"id": "DZ-28"
},
{
"name": "Mascara Province",
"id": "DZ-29"
},
{
"name": "Médéa Province",
"id": "DZ-26"
},
{
"name": "Mila Province",
"id": "DZ-43"
},
{
"name": "Mostaganem Province",
"id": "DZ-27"
},
{
"name": "Naâma Province",
"id": "DZ-45"
},
{
"name": "Oran Province",
"id": "DZ-31"
},
{
"name": "Ouargla Province",
"id": "DZ-30"
},
{
"name": "Oum El Bouaghi Province",
"id": "DZ-04"
},
{
"name": "Province of Tamanrasset",
"id": "DZ-11"
},
{
"name": "Relizane Province",
"id": "DZ-48"
},
{
"name": "Saïda Province",
"id": "DZ-20"
},
{
"name": "Setif",
"id": "DZ-19"
},
{
"name": "Sidi-Bel-Abbes",
"id": "DZ-22"
},
{
"name": "Skikda Province",
"id": "DZ-21"
},
{
"name": "Souk Ahras Province",
"id": "DZ-41"
},
{
"name": "Tebessa",
"id": "DZ-12"
},
{
"name": "Tiaret Province",
"id": "DZ-14"
},
{
"name": "Tindouf Province",
"id": "DZ-37"
},
{
"name": "Tipaza Province",
"id": "DZ-42"
},
{
"name": "Tissemsilt",
"id": "DZ-38"
},
{
"name": "Tizi Ouzou Province",
"id": "DZ-15"
},
{
"name": "Tlemcen Province",
"id": "DZ-13"
}
],
"name": "Algeria",
"id": "DZ"
},
{
"name": "American Samoa",
"id": "AS"
},
{
"children": [
{
"name": "Andorra la Vella",
"id": "AD-07"
},
{
"name": "Canillo",
"id": "AD-02"
},
{
"name": "Encamp",
"id": "AD-03"
},
{
"name": "Escaldes-Engordany",
"id": "AD-08"
},
{
"name": "La Massana",
"id": "AD-04"
},
{
"name": "Ordino",
"id": "AD-05"
},
{
"name": "Sant Julià de Lòria",
"id": "AD-06"
}
],
"name": "Andorra",
"id": "AD"
},
{
"children": [
{
"name": "Bengo Province",
"id": "AO-BGO"
},
{
"name": "Benguela Province",
"id": "AO-BGU"
},
{
"name": "Bié Province",
"id": "AO-BIE"
},
{
"name": "Cabinda Province",
"id": "AO-CAB"
},
{
"name": "Cuando Cubango Province",
"id": "AO-CCU"
},
{
"name": "Cuanza Norte Province",
"id": "AO-CNO"
},
{
"name": "Cuanza Sul",
"id": "AO-CUS"
},
{
"name": "Cunene",
"id": "AO-CNN"
},
{
"name": "Huambo Province",
"id": "AO-HUA"
},
{
"name": "Huila Province",
"id": "AO-HUI"
},
{
"name": "Luanda Province",
"id": "AO-LUA"
},
{
"name": "Lunda Norte",
"id": "AO-LNO"
},
{
"name": "Lunda Sul Province",
"id": "AO-LSU"
},
{
"name": "Malanje Province",
"id": "AO-MAL"
},
{
"name": "Moxico Province",
"id": "AO-MOX"
},
{
"name": "Namibe Province",
"id": "AO-NAM"
},
{
"name": "Uíge Province",
"id": "AO-UIG"
},
{
"name": "Zaire Province",
"id": "AO-ZAI"
}
],
"name": "Angola",
"id": "AO"
},
{
"name": "Anguilla",
"id": "AI"
},
{
"name": "Antarctica",
"id": "AQ"
},
{
"children": [
{
"name": "Barbuda",
"id": "AG-10"
},
{
"name": "Redonda",
"id": "AG-11"
},
{
"name": "Saint George",
"id": "AG-03"
},
{
"name": "Saint John",
"id": "AG-04"
},
{
"name": "Saint Mary",
"id": "AG-05"
},
{
"name": "Saint Paul",
"id": "AG-06"
},
{
"name": "Saint Peter",
"id": "AG-07"
},
{
"name": "Saint Philip",
"id": "AG-08"
}
],
"name": "Antigua & Barbuda",
"id": "AG"
}
],
"name": "Worldwide",
"id": ""
}
}{
"status": "error",
"msg": "Unauthenticated"
}Example request:
curl --location --request GET 'https://api.serphouse.com/trends/country/list' \
--header 'Authorization: Bearer <YOUR_API_KEY>'require "uri"
require "net/http"
url = URI("https://api.serphouse.com/trends/country/list")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = "Bearer <YOUR_API_KEY>"
response = https.request(request)
puts response.read_body
import requests
url = "https://api.serphouse.com/trends/country/list"
payload={}
headers = {
'Authorization': 'Bearer <YOUR_API_KEY>'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)var axios = require('axios');
var config = {
method: 'get',
url: 'https://api.serphouse.com/trends/country/list',
headers: {
'Authorization': 'Bearer <YOUR_API_KEY>'
}
};
axios(config)
.then(function (response) {
console.log(JSON.stringify(response.data));
})
.catch(function (error) {
console.log(error);
});
<?php
$serphouse = new SERPHouse\SERPHouseClient('YOUR_API_KEY');
$res = $serphouse->trends->countryStateList();
echo $res->getResponse();
OkHttpClient client = new OkHttpClient().newBuilder().build();
Request request = new Request.Builder()
.url("https://api.serphouse.com/trends/country/list")
.method("GET", body)
.addHeader("Authorization", "Bearer <YOUR_API_KEY>")
.build();
Response response = client.newCall(request).execute();
System.out.println(response.body().string());var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer <YOUR_API_KEY>");
var requestOptions = {
method: 'GET',
headers: myHeaders,
redirect: 'follow'
};
fetch("https://api.serphouse.com/trends/country/list", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.serphouse.com/trends/country/list"
method := "GET"
client := &http.Client {
}
req, err := http.NewRequest(method, url, nil)
if err != nil {
fmt.Println(err)
return
}
req.Header.Add("Authorization", "Bearer <YOUR_API_KEY>")
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}var client = new RestClient("https://api.serphouse.com/trends/country/list");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <YOUR_API_KEY>");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);Last updated