← APIs / Countrylayer
Verified

Countrylayer

Apiosk Basicsby Apiosk Basics · General

Country data: population, currencies, languages, capitals, calling codes, regional blocs and more.

dataapi
Price per request
$0.08
Base URL
https://gateway.apiosk.com/countrylayer
Technical Specs
Auth MethodapiKey
Response FormatJSON
Endpoints9
Endpoints
MethodPathDescriptionCost
GET /all All countries.
$0.08 default
View details
GET /alpha Country by ISO alpha code: append /{code}.
$0.08 default
View details
GET /callingcode Countries by calling code: append /{code}.
$0.08 default
View details
GET /capital Country by capital city: append /{capital}, e.g. /capital/berlin.
$0.08 default
View details
GET /currency Countries by currency code: append /{code}.
$0.08 default
View details
GET /language Countries by language code: append /{code}.
$0.08 default
View details
GET /name Country by name: append /{name}.
$0.08 default
View details
GET /region Countries by region: append /{region}.
$0.08 default
View details
GET /regionalbloc Countries by regional bloc: append /{bloc}.
$0.08 default
View details
Endpoint documentation
GET/all
$0.08 default
Description

All countries.

Pricing
$0.08 default
Parameters
{
  "properties": {},
  "required": [],
  "type": "object"
}
GET/alpha
$0.08 default
Description

Country by ISO alpha code: append /{code}.

Pricing
$0.08 default
Parameters
{
  "properties": {
    "code": {
      "description": "ISO 3166-1 alpha-2 or alpha-3 country code, appended as a path segment.",
      "example": "us",
      "type": "string",
      "x-parameter-location": "path"
    }
  },
  "required": [
    "code"
  ],
  "type": "object"
}
GET/callingcode
$0.08 default
Description

Countries by calling code: append /{code}.

Pricing
$0.08 default
Parameters
{
  "properties": {
    "callingcode": {
      "description": "International calling code without the plus sign, appended as a path segment.",
      "example": "31",
      "type": "string",
      "x-parameter-location": "path"
    }
  },
  "required": [
    "callingcode"
  ],
  "type": "object"
}
GET/capital
$0.08 default
Description

Country by capital city: append /{capital}, e.g. /capital/berlin.

Pricing
$0.08 default
Parameters
{
  "properties": {
    "capital": {
      "description": "Capital city name, appended as a path segment.",
      "example": "berlin",
      "type": "string",
      "x-parameter-location": "path"
    }
  },
  "required": [
    "capital"
  ],
  "type": "object"
}
GET/currency
$0.08 default
Description

Countries by currency code: append /{code}.

Pricing
$0.08 default
Parameters
{
  "properties": {
    "currency": {
      "description": "ISO 4217 currency code, appended as a path segment.",
      "example": "eur",
      "type": "string",
      "x-parameter-location": "path"
    }
  },
  "required": [
    "currency"
  ],
  "type": "object"
}
GET/language
$0.08 default
Description

Countries by language code: append /{code}.

Pricing
$0.08 default
Parameters
{
  "properties": {
    "language": {
      "description": "ISO 639-1 language code, appended as a path segment.",
      "example": "nl",
      "type": "string",
      "x-parameter-location": "path"
    }
  },
  "required": [
    "language"
  ],
  "type": "object"
}
GET/name
$0.08 default
Description

Country by name: append /{name}.

Pricing
$0.08 default
Parameters
{
  "properties": {
    "name": {
      "description": "Full or partial country name, appended as a path segment.",
      "example": "germany",
      "type": "string",
      "x-parameter-location": "path"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}
GET/region
$0.08 default
Description

Countries by region: append /{region}.

Pricing
$0.08 default
Parameters
{
  "properties": {
    "region": {
      "description": "Region name: africa, americas, asia, europe or oceania. Appended as a path segment.",
      "example": "europe",
      "type": "string",
      "x-parameter-location": "path"
    }
  },
  "required": [
    "region"
  ],
  "type": "object"
}
GET/regionalbloc
$0.08 default
Description

Countries by regional bloc: append /{bloc}.

Pricing
$0.08 default
Parameters
{
  "properties": {
    "regionalbloc": {
      "description": "Regional bloc acronym: EU, EFTA, CARICOM, PA, AU, USAN, EEU, AL, ASEAN, CAIS, CEFTA, NAFTA or SAARC. Appended as a path segment.",
      "example": "eu",
      "type": "string",
      "x-parameter-location": "path"
    }
  },
  "required": [
    "regionalbloc"
  ],
  "type": "object"
}