Altoal LogoCountries API
HomeExplorerDocsFAQContact
Altoal LogoCountries API

Comprehensive structured country data API with detailed information about geography, economy, demographics, and more.

Product

  • Explorer
  • Docs
  • FAQ

Resources

  • Contact

© 2025 Countries API. All rights reserved.

A product of Altoal

On this page

Documentation

Learn how to integrate the Countries API into your application with our comprehensive guides and examples.

Quick Start

Start making requests in seconds. No authentication, no rate limits, no hassle.

Introduction

The Countries API is a free, static JSON API providing comprehensive structured data from the CIA World Factbook for 250+ countries and territories. No API keys, no authentication, no rate limits—just simple HTTP GET requests.

Data is AI-extracted from the CIA Factbook and structured into consistent JSON schemas, updated regularly via automated pipeline. Each entity includes metadata plus 5 comprehensive sections: introduction, geography, people & society, government, and economy. Historical snapshots are preserved indefinitely for tracking changes over time.

CORS Enabled

Cross-origin requests are fully supported. Access the API from any domain, including browser-based applications.

No Authentication

No API keys or tokens required. Make requests directly without any signup or authentication flow.

No Rate Limits

Make as many requests as needed. We ask that you implement reasonable caching and avoid unnecessary requests.

Global CDN

Distributed via CDN with edge caching for low-latency access worldwide. Typical response times under 100ms.

API

URL

Signatures

GET/metadata.json

Returns a lightweight index containing structured metadata for all 250+ entities. Includes ISO codes, currencies, regional classifications, population, area, capital cities, and core statistics. Perfect for building search interfaces, dropdown selectors, or filter menus.

View Response Schema
api_version
string
required
data_version
string
required
updated_at
string
required
next_update_estimated
string
required
total
number
required
base_url
string
required
endpoints
object
required
metadata
string
required
country
string
required
snapshot
string
required
confidence
string
required
latest_snapshot
string
required
latest_confidence
string
required
countries
dictionary[string, object]
required
name
string
required
type
string
required
Allowed values:
sovereign statedependentothermiscellaneous
code
object
required
iso2
string
required
iso3
string
required
region
string
required
subregion
string
required
capital
string
coordinates
object
latitude
number
required
longitude
number
required
area_sq_km
number
population
number
gdp
number
currency
object
required
code
string
required
name
string
required
symbol
string
calling_code
string
required
statistics
object
required
sovereign_states
number
required
dependent
number
required
other
number
required
miscellaneous
number
required
snapshots
object
required
latest
string
required
total
number
required
available
array[string]
required
confidence
object
required
latest
string
required
total
number
required
available
array[string]
required
GET/name/{slug}.json

Returns complete structured data for a specific country or territory. The slug is a lowercase, hyphenated version of the country name (e.g., "united-states", "cote-d-ivoire"). Includes comprehensive sections: introduction, geography, people & society, government, and economy.

View Response Schema
name
string
required
identity
object
iso
object
required
alpha2
string
required
alpha3
string
required
numeric
string
required
names
object
required
common
string
required
official
string
required
native
string
alternatives
array[string]
former
array[string]
classification
object
required
type
string
required
Allowed values:
sovereign statedependentothermiscellaneous
region
string
required
Allowed values:
AfricaAmericasAsiaEuropeOceaniaAntarctica
subregion
required
intermediate_region
string
continent
string
required
landlocked
boolean
required
island_nation
boolean
required
communication
object
required
calling_code
string
required
tld
string
required
currency
object
required
code
string
required
name
string
required
symbol
string
memberships
object
required
united_nations
object
introduction
object
background
object
required
rank
number
value
object
required
notes
array[string]
preliminary_statement
object
geography
object
location
object
geographic_coordinates
object
rank
number
value
object
required
notes
array[string]
map_references
object
area
object
rank
number
value
object
required
notes
array[string]
area_comparative
object
land_boundaries
object
total
object
required
border_countries
object
required
coastline
object
maritime_claims
object
rank
number
value
object
required
notes
array[string]
climate
object
terrain
object
elevation
object
rank
number
value
object
required
notes
array[string]
natural_resources
object
rank
number
value
array[object]
required
notes
array[string]
land_use
object
agricultural_land
object
forest
object
other_land
object
irrigated_land
object
major_lakes
object
fresh_water
object
salt_water
object
major_rivers
object
major_watersheds
object
atlantic_ocean_drainage
object
pacific_ocean_drainage
object
indian_ocean_drainage
object
arctic_ocean_drainage
object
southern_ocean_drainage
object
major_aquifers
object
natural_hazards
object
hazards
object
volcanism
object
additional_notes
object
people_and_society
object
population
object
rank
number
value
object
required
notes
array[string]
nationality
object
rank
number
value
object
required
notes
array[string]
ethnic_groups
object
rank
number
value
array[object]
required
notes
array[string]
languages
object
rank
number
value
array[object]
required
notes
array[string]
religions
object
rank
number
value
array[object]
required
notes
array[string]
age_structure
object
rank
number
value
object
required
notes
array[string]
dependency_ratio
object
rank
number
value
object
required
notes
array[string]
potential_support_ratio
object
rank
number
value
object
required
notes
array[string]
median_age
object
rank
number
value
object
required
notes
array[string]
population_growth_rate
object
birth_rate
object
rank
number
value
object
required
notes
array[string]
death_rate
object
net_migration_rate
object
population_distribution
object
urbanization
object
rank
number
value
object
required
notes
array[string]
major_urban_areas
object
rank
number
value
array[object]
required
notes
array[string]
sex_ratio
object
rank
number
value
object
required
notes
array[string]
mothers_mean_age_at_first_birth
object
maternal_mortality_ratio
object
infant_mortality_rate
object
rank
number
value
object
required
notes
array[string]
life_expectancy_at_birth
object
rank
number
value
object
required
notes
array[string]
total_fertility_rate
object
gross_reproduction_rate
object
drinking_water_source
object
rank
number
value
object
required
notes
array[string]
health_expenditure
object
rank
number
value
object
required
notes
array[string]
physician_density
object
hospital_bed_density
object
sanitation_facility_access
object
rank
number
value
object
required
notes
array[string]
obesity_adult_prevalence_rate
object
alcohol_consumption_per_capita
object
rank
number
value
object
required
notes
array[string]
tobacco_use
object
rank
number
value
object
required
notes
array[string]
children_under_5_underweight
object
currently_married_women_15_49
object
education_expenditure
object
rank
number
value
object
required
notes
array[string]
school_life_expectancy
object
rank
number
value
object
required
notes
array[string]
government
object
country_name
object
rank
number
value
object
required
notes
array[string]
government_type
object
capital
object
rank
number
value
object
required
notes
array[string]
administrative_divisions
object
rank
number
value
dictionary[string, array]
required
notes
array[string]
dependent_areas
object
independence
object
national_holiday
object
legal_system
object
constitution
object
rank
number
value
object
required
notes
array[string]
international_law_organization_participation
object
citizenship
object
rank
number
value
object
required
notes
array[string]
suffrage
object
executive_branch
object
chief_of_state
object
head_of_government
object
cabinet
object
elections
object
legislative_branch
object
legislature_name
object
legislative_structure
object
lower_chamber
object
upper_chamber
object
judicial_branch
object
rank
number
value
object
required
notes
array[string]
political_parties
object
international_organization_participation
object
flag
object
rank
number
value
object
required
notes
array[string]
national_symbols
object
national_colors
object
national_anthem
object
rank
number
value
object
required
notes
array[string]
national_heritage
object
rank
number
value
object
required
notes
array[string]
economy
object
overview
object
gdp
object
real
object
nominal
object
by_sector
object
by_end_use
object
inflation_rate
object
agricultural_products
object
industries
object
industrial_production_growth_rate
object
labor_force
object
unemployment_rate
object
youth_unemployment_rate
object
rank
number
value
object
required
notes
array[string]
poverty_rate
object
gini_index
object
household_expenditures
object
rank
number
value
object
required
notes
array[string]
household_income
object
rank
number
value
object
required
notes
array[string]
remittances
object
budget
object
rank
number
value
object
required
notes
array[string]
public_debt
object
taxes_and_other_revenues
object
current_account_balance
object
exports
object
annual
object
partners
object
commodities
object
imports
object
annual
object
partners
object
commodities
object
foreign_exchange_and_gold_reserves
object
external_debt
object
_meta
object
schema_version
string
required
last_updated
string
required
sources
array[object]
required
name
string
required
url
string
required
date
string
required
quality
string
Allowed values:
highmediumlowestimatedunknown
quality
object
completeness
number
required
confidence
number
required
missing_sections
array[string]
low_confidence_sections
array[string]
extraction
object
method
string
required
Allowed values:
gpt-4gpt-4ogpt-4o-minirule-basedmanualcalculated
model
string
duration_ms
number
date
string
required
GET/snapshots/{date}.json

Returns a complete data dump of all entities at a specific point in time. Use "LATEST" for the most recent snapshot, or specify a timestamp in YYYY-MM-DD-HH-MM format for historical data. Organized by category (countries, territories, other) with full structured data for every entity.

View Response Schema
snapshot_date
string
required
api_version
string
required
total
number
required
statistics
object
required
sovereign_states
number
required
dependent
number
required
other
number
required
miscellaneous
number
required
countries
dictionary[string, object]
required
name
string
required
identity
object
iso
object
required
names
object
required
classification
object
required
communication
object
required
currency
object
required
memberships
object
required
introduction
object
background
object
required
preliminary_statement
object
geography
object
location
object
geographic_coordinates
object
map_references
object
area
object
area_comparative
object
land_boundaries
object
coastline
object
maritime_claims
object
climate
object
terrain
object
elevation
object
natural_resources
object
land_use
object
irrigated_land
object
major_lakes
object
major_rivers
object
major_watersheds
object
major_aquifers
object
natural_hazards
object
additional_notes
object
people_and_society
object
population
object
nationality
object
ethnic_groups
object
languages
object
religions
object
age_structure
object
dependency_ratio
object
potential_support_ratio
object
median_age
object
population_growth_rate
object
birth_rate
object
death_rate
object
net_migration_rate
object
population_distribution
object
urbanization
object
major_urban_areas
object
sex_ratio
object
mothers_mean_age_at_first_birth
object
maternal_mortality_ratio
object
infant_mortality_rate
object
life_expectancy_at_birth
object
total_fertility_rate
object
gross_reproduction_rate
object
drinking_water_source
object
health_expenditure
object
physician_density
object
hospital_bed_density
object
sanitation_facility_access
object
obesity_adult_prevalence_rate
object
alcohol_consumption_per_capita
object
tobacco_use
object
children_under_5_underweight
object
currently_married_women_15_49
object
education_expenditure
object
school_life_expectancy
object
government
object
country_name
object
government_type
object
capital
object
administrative_divisions
object
dependent_areas
object
independence
object
national_holiday
object
legal_system
object
constitution
object
international_law_organization_participation
object
citizenship
object
suffrage
object
executive_branch
object
legislative_branch
object
judicial_branch
object
political_parties
object
international_organization_participation
object
flag
object
national_symbols
object
national_colors
object
national_anthem
object
national_heritage
object
economy
object
overview
object
gdp
object
inflation_rate
object
agricultural_products
object
industries
object
industrial_production_growth_rate
object
labor_force
object
unemployment_rate
object
youth_unemployment_rate
object
poverty_rate
object
gini_index
object
household_expenditures
object
household_income
object
remittances
object
budget
object
public_debt
object
taxes_and_other_revenues
object
current_account_balance
object
exports
object
imports
object
foreign_exchange_and_gold_reserves
object
external_debt
object
_meta
object
schema_version
string
required
last_updated
string
required
sources
$ref(#/definitions/DataSource)[]
required
quality
object
extraction
object
GET/confidence/{date}.json

Returns validation and quality metrics for a specific data extraction. Use "LATEST" for the most recent report, or specify a timestamp in YYYY-MM-DD-HH-MM format. Includes field-level confidence scores, missing data reports, and overall data quality statistics.

View Response Schema
snapshot_date
string
required
generated_at
string
required
api_version
string
required
overview
object
required
total_countries
number
required
validation_passed
number
required
validation_failed
number
required
overall_completeness
number
required
extraction_model
string
required
sections
dictionary[string, anyOf]
required
number
any
countries
array[object]
required
slug
string
required
name
string
required
completeness
number
required
validated
boolean
required

Questions or feedback? Contact us

# Get all countries metadata curl https://countries.altoal.com/api/v1/metadata.json # Get specific country curl https://countries.altoal.com/api/v1/name/united-states.json # Get complete dataset curl https://countries.altoal.com/api/v1/snapshots/LATEST.json
https://countries.altoal.com/api/v1