← Docs

Continent API

A continent by code, or every country in it.

Look up a continent by two-letter code. Country and postal hang off this layer.

By code

Pass a two-letter code: NA, EU, AF, AS, OC, SA, or AN. Name, region, population, and area come back.

GET
api.parseapi.com/continent/{code}
NA, EU, AF, AS, OC, SA, or AN. Name, region, population, area
Explore
Parameters 2
codestring · path · required

Two-letter continent code

Values: NA, EU, AF, AS, OC, SA, AN

langstring · query · optional

Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.

Length: 2 to 64 characters

Run uses the free demo on API 2.0.0. Copied code uses your API key when signed in, or YOUR_API_KEY when signed out.

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.continent("na");
console.log(result);

Run on your server with a secret key. Calling from a browser or app?

Example response
{
  "continent": "NA",
  "name": "North America",
  "region": "Americas",
  "subregion": "Northern America",
  "population": 600000000,
  "area": 24709000,
  "emoji": "🌎"
}

Response fields

continentstring
Continent code (NA, EU, AF, AS, OC, SA, AN)
namestring or null
Common name
regionstring or null
Broader region
subregionstring or null
UN subregion
populationinteger or null
Population estimate
areainteger or null
Total area in km²
emojistring or null
Continent emoji

Countries

Every country in a continent. Handy for region pickers and cascading forms.

GET
api.parseapi.com/continent/{code}/countries
Every country in a continent
Explore
Parameters 2
codestring · path · required

Two-letter continent code

Values: NA, EU, AF, AS, OC, SA, AN

langstring · query · optional

Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.

Length: 2 to 64 characters

Run uses the free demo on API 2.0.0. Copied code uses your API key when signed in, or YOUR_API_KEY when signed out.

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.continent.countries("na");
console.log(result);

Run on your server with a secret key. Calling from a browser or app?

Example response (excerpt)

This example shows selected fields or shortened lists. Run the request for the full response.

{
  "continent": "NA",
  "countries": [
    {
      "country": "CA",
      "name": "Canada",
      "emoji": "🇨🇦",
      "calling_code": "+1"
    },
    {
      "country": "MX",
      "name": "Mexico",
      "emoji": "🇲🇽",
      "calling_code": "+52"
    },
    {
      "country": "US",
      "name": "United States",
      "emoji": "🇺🇸",
      "calling_code": "+1"
    }
  ]
}

Response fields

continentstring
Continent code
countriesarray
Every country in the continent
countries[].countrystring or null
ISO2 country code
countries[].namestring or null
Country name
countries[].emojistring or null
Flag emoji
countries[].calling_codestring or null
International calling code with plus (+1, +44)

Display language

Pass lang with a language tag such as fr, pt-BR, or zh-Hant. Continent name; country names and currency names in the countries list. All 7 continents and 250 country records have names in each of the 41 choices.

Omitting lang preserves the original response. Codes, IDs, numeric facts and native-name fields stay unchanged. Missing translations keep their existing source value; unknown values stay null. A preserved name_local may equal the translated name.

Send a chosen browser preference explicitly, for example { lang: navigator.language } in your JavaScript SDK options. The API does not read Accept-Language automatically. Unsupported regions fall back to their supported base language; unsupported languages or scripts use English. Empty, invalid or repeated tags return 400.

Content-Language identifies languages used in translated display fields and known English fallbacks. This option follows the current API contract. Requests selecting frozen 1.0.0 retain that contract. Select API 2.0.0 to use display language.

41 display language choices
Language tagLanguage
enAmerican English
zh-Hans简体中文
frfrançais (France)
deDeutsch
ititaliano
ja日本語
ko한국어
esespañol de España
arالعربية
bgбългарски
cacatalà
hrhrvatski
csčeština
dadansk
nlNederlands
fisuomi
elΕλληνικά
heעברית
hiहिन्दी
humagyar
idIndonesia
kkқазақ тілі
msMelayu
nbnorsk bokmål
plpolski
ptportuguês (Brasil)
roromână
ruрусский
skslovenčina
svsvenska
thไทย
trTürkçe
ukукраїнська
viTiếng Việt
zh-Hant繁體中文
en-AUAustralian English
en-GBBritish English
fr-CAfrançais canadien
es-419español latinoamericano
pt-PTportuguês europeu
zh-Hant-HK繁體中文(中國香港特別行政區)

Questions? Email