Continent data · Country lists · Translated names
Continent API
From a continent code
to a country picker.
Build regional filters and country dropdowns with stable codes, names, flags and calling codes. Look up a continent or get the countries and territories in it.
Start free. Continent lookups, lists and translated names on every plan.
Try it
From the region to its countries
The list your
interface needs.
Fill a continent dropdown, load its countries, or read a regional overview. Each task returns ready-to-use JSON.
Look up North America.
A two-letter code returns its name, region, population estimate and area in square kilometers. Population combines country estimates from different dates.
Request
curl "https://api.parseapi.com/continent/NA" \
-H "X-API-Key: YOUR_API_KEY"Example response
Names for your audience
Change the name.
Keep the code.
Choose a display language with lang on the continent directory, a single lookup or its country list. Save the same stable code when your users change languages.
Explore translated names- English
- Asia
- AS
- Japanese
- アジア
- AS
Continent → Country → State
Build pickers that stay connected.
Start with a continent, let someone choose a country, then load its states. Keep the returned codes together as they move through your form.
List countries in North America
/continent/NA/countries
One country from the response
{
"continent": "NA",
"countries": [
{
"country": "US",
"name": "United States",
"emoji": "🇺🇸",
"calling_code": "+1"
}
]
}Use the returned country codes and names for the first picker. The United States has country code US.
Use
countries[].countryLoad the selected country’s states
/country/US/states
Pass the selected country code to Country. Use each state’s name and type in the next picker.
After a country is selected
Use
countries[].country+states[].stateOpen the selected state
/state/DE?country=US
Selecting Delaware gives you DE. Keep country=US with it so the state code identifies the right place.
After loading that country's states and selecting one
Use this in your app
// Run on your server with PARSEAPI_KEY in the environment.
const key = process.env.PARSEAPI_KEY;
if (!key) throw new Error('Set PARSEAPI_KEY on your server.');
const segment = value => encodeURIComponent(value);
const timezonePath = zone => zone.split('/').map(segment).join('/');
async function lookup(path, query = {}) {
const url = new URL(path, 'https://api.parseapi.com');
url.search = new URLSearchParams(query).toString();
const response = await fetch(url, {
headers: { 'X-API-Key': key, 'Parse-Version': '2.0.0' },
signal: AbortSignal.timeout(10000),
});
if (!response.ok) {
const error = await response.json().catch(() => null);
throw new Error(error?.message ?? 'ParseAPI returned HTTP ' + response.status);
}
return response.json();
}
const continent = await lookup('/continent/NA/countries');
// Example selections from your country and state pickers.
const selectedCountryCode = 'US';
const selectedStateCode = 'DE';
const country = continent.countries?.find(row => row.country === selectedCountryCode);
if (!country?.country) throw new Error('Choose a country from the returned list.');
const states = await lookup('/country/' + segment(country.country) + '/states');
const selectedState = states.states?.find(row => row.state === selectedStateCode);
const state = selectedState?.state
? await lookup('/state/' + segment(selectedState.state), { country: country.country })
: null;
console.log({ states, state });Coverage
Seven continents.
One clear catalog.
Use two-letter continent codes to organize your interface. Country lists include territories and keep each country's own code, flag and calling code.
- A regional overview
- Continent lookups include region labels, population and area in square kilometers. Population combines country estimates from different dates.
- Continue with a country
- Use its code with Country for country-level details, languages and currencies.
- AFAfrica
- ANAntarctica
- ASAsia
- EUEurope
- NANorth America
- OCOceania
- SASouth America
From the first request to your app
Build with a code.
Grow with one key.
Start with a continent lookup. Use the same key for its country list and the other place APIs your app needs.
HTTP, SDKs and MCP
Copy a request above, then follow the reference for parameters, complete responses and errors. Use an SDK in your language or connect through MCP.
Before you build.
Which continent codes can I use?
AF, AN, AS, EU, NA, OC and SA. Codes are case insensitive. GET /continent returns all seven codes with their names.
Does the country list include territories?
Yes. Each list includes the countries and territories assigned to that continent in the catalog, sorted by display name. Use the returned country code as the stable value in your app.
Can I translate the names?
Add lang to the directory, continent lookup or country list. Display names follow the requested supported language, with a base-name fallback where a translation is missing. Codes and statistics keep their existing values. Omitting lang returns the original English names.
How should I use the population and area?
Area is in square kilometers. Population is a sum of country estimates from different dates, suitable for a broad regional overview. It has no single observation year. Unknown values remain null.
Is Europe the same as the European Union?
Europe is a continent. The European Union is a country group with its own membership. Country Core includes recorded group memberships in blocs.
Does a country list use one request per country?
A continent country-list call counts as one API request. Continent lookup, lists and translated names are available on every plan, using your shared ParseAPI request allowance.
Continent API pricing
Put the world in your app.
Your API request allowance is shared across ParseAPI products. A complete continent or country list counts as one request.
Free
Start with a free API key.
Room to grow
Choose your capacity on Plans.