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>

200: OK Successful operation

{
    "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": ""
    }
}

401: Unauthorized Unauthenticated

{
    "status": "error",
    "msg": "Unauthenticated"
}

Example request:

BASH

curl --location --request GET 'https://api.serphouse.com/trends/country/list' \
--header 'Authorization: Bearer <YOUR_API_KEY>'

RUBY

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

PYTHON

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)

NODE.JS

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

<?php
$serphouse = new SERPHouse\SERPHouseClient('YOUR_API_KEY');
$res = $serphouse->trends->countryStateList();
echo $res->getResponse();

JAVA

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());

JAVASCRIPTS

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));

GO

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))
}

C#/.NET

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);