SearchCtrl+K

Cities API Reference

Retrieve all cities for a given country with latitude, longitude, administrative unit details, and ISO country codes. Optionally filter by administrative unit.

GEThttps://api.apifreaks.com/v1.0/geo/cities

Test

Returns all cities for a country, optionally filtered by administrative unit using the admin_unit parameter.

Getting Started

Authentication

Pass your API key as the apiKey parameter in every request.

API Version

This is version v1.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v1.0/geo/cities?country=PK' \
  -H 'X-apiKey: API-KEY'

Response

{
  "cities": [
    {
      "name": "Aberdeen",
      "latitude": 57.14369,
      "longitude": -2.09814,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Balmedie",
      "latitude": 57.25052,
      "longitude": -2.06163,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Boddam",
      "latitude": 57.47076,
      "longitude": -1.78009,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Cove",
      "latitude": 57.1,
      "longitude": -2.08333,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Cruden Bay",
      "latitude": 57.41797,
      "longitude": -1.85313,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Cults",
      "latitude": 57.11667,
      "longitude": -2.16667,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Dyce",
      "latitude": 57.20522,
      "longitude": -2.17676,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Ellon",
      "latitude": 57.36405,
      "longitude": -2.07313,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Fraserburgh",
      "latitude": 57.68744,
      "longitude": -2.01844,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Inverbervie",
      "latitude": 56.84463,
      "longitude": -2.27997,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Kingswells",
      "latitude": 57.15798,
      "longitude": -2.22426,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Kintore",
      "latitude": 57.23721,
      "longitude": -2.3454,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    }
  ]
}

API Request

Query Parameters

The following parameters can be used in your API requests.

formatoptionalStringdefault: json

Response format: 'json' (default) or 'xml'.

countryrequiredString

Country code in ISO 3166-1 alpha-2 format.

admin_unitoptionalString

Administrative unit code used to filter cities within a specific region.

API Response Schema

A successful request returns a 200 OK response with an array of city objects.

An array of city objects for the specified country, optionally filtered by admin unit.

Error Status & Codes

See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.

400

Only ISO 3166-1 alpha-2 codes country codes are supported.

400

Please provide a valid admin code.

404

This Country does not have any admin units associated with it.

Cities API Reference

Retrieve all cities for a given country with latitude, longitude, administrative unit details, and ISO country codes. Optionally filter by administrative unit.

GEThttps://api.apifreaks.com/v1.0/geo/cities

Test

Returns all cities for a country, optionally filtered by administrative unit using the admin_unit parameter.

Getting Started

Authentication

Pass your API key as the apiKey parameter in every request.

API Version

This is version v1.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v1.0/geo/cities?country=PK' \
  -H 'X-apiKey: API-KEY'

Response

{
  "cities": [
    {
      "name": "Aberdeen",
      "latitude": 57.14369,
      "longitude": -2.09814,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Balmedie",
      "latitude": 57.25052,
      "longitude": -2.06163,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Boddam",
      "latitude": 57.47076,
      "longitude": -1.78009,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Cove",
      "latitude": 57.1,
      "longitude": -2.08333,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Cruden Bay",
      "latitude": 57.41797,
      "longitude": -1.85313,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Cults",
      "latitude": 57.11667,
      "longitude": -2.16667,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Dyce",
      "latitude": 57.20522,
      "longitude": -2.17676,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Ellon",
      "latitude": 57.36405,
      "longitude": -2.07313,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Fraserburgh",
      "latitude": 57.68744,
      "longitude": -2.01844,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Inverbervie",
      "latitude": 56.84463,
      "longitude": -2.27997,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Kingswells",
      "latitude": 57.15798,
      "longitude": -2.22426,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    },
    {
      "name": "Kintore",
      "latitude": 57.23721,
      "longitude": -2.3454,
      "admin_unit": {
        "name": "Aberdeen",
        "admin_code": "ABE",
        "admin_level": "council area"
      },
      "iso_alpha_2": "GB"
    }
  ]
}

API Request

Query Parameters

The following parameters can be used in your API requests.

formatoptionalStringdefault: json

Response format: 'json' (default) or 'xml'.

countryrequiredString

Country code in ISO 3166-1 alpha-2 format.

admin_unitoptionalString

Administrative unit code used to filter cities within a specific region.

API Response Schema

A successful request returns a 200 OK response with an array of city objects.

An array of city objects for the specified country, optionally filtered by admin unit.

Error Status & Codes

See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.

400

Only ISO 3166-1 alpha-2 codes country codes are supported.

400

Please provide a valid admin code.

404

This Country does not have any admin units associated with it.

Quick Links

Quick Links

Cities API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Error Status & Codes

Docs

Integrations

Pricing & Accounts

Quick Links

Quick Links

Cities API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Error Status & Codes

Docs

Integrations

Pricing & Accounts