GobalDB API

GobalDB API

If you need global city, region, and country data, this is the API for you.

API description

With this API you can obtain statistics about the world's cities, regions, and nations. Filter cities by prefix of their names, nation, location, time zone, and even minimum population (currently over 500,000 towns, cities, and counties). Show the findings in several languages and sort by population, elevation, name, country code, or any combination of these. Industry standard practices are followed by RESTful API, including HATEOAS-style links to help page results. 

GobalDB API is the perfect tool for obtaining information about cities, regions and countries. With this API you can, for example: retrieve and update records in Global Data, perform CRUD operations on single or multiple Global Data Table records at once, clear an entire Global Data Table, list the accessible Global Data structures available to the Global Data API, and many more things.

Features:
  • Get Administrative Divisions info: Filter by optional criteria to find administrative divisions data.
  • Get Administrative Divisions Details: Get information on a certain administrative division, such as its location, population, and elevation above sea level (if available).
  • Get Cities data: Find cities’ information based on criteria. 

 

The information obtained is (among many more):

  • Name of division or city.
  • Region and its code.
  • Latitude and longitude.
  • Population.

Documentation

Endpoints

Administrative Divisions:

Filter by optional criteria to find administrative divisions. If no criteria are specified, all known divisions with a population of at least 1000 will be returned.

Free plans have a limit of 10 results per query. 

 

 

Endpoint JSON response example: 

 

{
  "data": [
    {
      "id": 170760,
      "wikiDataId": "Q306343",
      "name": "Abbeville County",
      "country": "United States of America",
      "countryCode": "US",
      "region": "South Carolina",
      "regionCode": "SC",
      "latitude": 34.23,
      "longitude": -82.45,
      "population": 24932
    },
    {
      "id": 170276,
      "wikiDataId": "Q337402",
      "name": "Acadia Parish",
      "country": "United States of America",
      "countryCode": "US",
      "region": "Louisiana",
      "regionCode": "LA",
      "latitude": 30.266666666,
      "longitude": -92.4,
      "population": 62577
    },
    {
      "id": 171067,
      "wikiDataId": "Q49289",
      "name": "Accomack County",
      "country": "United States of America",
      "countryCode": "US",
      "region": "Virginia",
      "regionCode": "VA",
      "latitude": 37.76,
      "longitude": -75.76,
      "population": 32973
    },
GET http://zylalabs.com/api/18/gobaldb+api/71/administrative+divisions

API Features

Object Description
maxPopulation [Required] Only divisions having no more than this population
countryIds [Required] Only divisions in these countries (comma-delimited country codes or WikiData ids). CountryIds can be found on https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements
minPopulation [Required] Only divisions having at least this population
Administrative Divisions Details:

Get information on a certain administrative division, such as its location, population, and elevation above sea level (if available).

GET http://zylalabs.com/api/18/gobaldb+api/72/administrative+divisions+details

API Features

Object Description
DATA [Required]
Cities:

Find cities based on criteria. If no criteria, you will get all known cities with a population over 1000.

GET http://zylalabs.com/api/18/gobaldb+api/73/cities

API Features

Object Description
location [Required] Only cities near this location. Latitude/longitude in ISO-6709 format: ±DD.DDDD±DDD.DDDD
limit [Required] The maximum number of results to retrieve
minPopulation [Required] Only cities having at least this population
sort [Required] How to sort the results. Format: ±SORTFIELD,±SORTFIELD where SORT_FIELD = countryCode | elevation | name | population
languageCode [Required] Display results in this language
types [Required] Only cities for these types (comma-delimited): CITY | ADM2
timeZoneIds [Required] Only cities in these time-zones
countryIds [Required] Only cities in these countries (comma-delimited country codes or WikiData ids)

API Access Key & Authentication

After signing up, every user is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the GobalDB API REST API, simply include your bearer token in the Authorization header.

Headers

Header Description
Authorization [Required] Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.


Simple Transparent Pricing

No long term commitments. One click upgrade/downgrade or cancellation. No questions asked.

Free 999 Requests / Monthly $0.00 / Monthly
Basic 9,999 Requests / Monthly $24.99 / Monthly
Pro 99,999 Requests / Monthly $49.99 / Monthly

API Provider: SoftDev

Useful links: