Skip to content

Latest commit

 

History

History
532 lines (447 loc) · 11.4 KB

README.md

File metadata and controls

532 lines (447 loc) · 11.4 KB

factbook.json - World Factbook Country Profiles in JSON

What's the World Factbook?

The World Factbook [1][2] published by the Central Intelligence Agency (CIA) offers free country profiles in the public domain (that is, no copyright(s), no rights reserved, no license).

Note: All country profiles use the original / official two-letter GEC (formerly FIPS) codes and NOT the ISO codes (you might be used to) e.g. au.json for Austria (and NOT at.json), gm.json for Germany (and NOT de.json), and so on.

Background

For a little background on this factbook project from the humble author, see the all-in-one page talk slides / notes titled Turn the World Factbook into Open (Structured) Data.

Find some more notes on query examples (and import instructions) for MongoDB from another talk. Happy exploring the world with JavaScript Object Notation (JSON) datasets / documents.

Frequently Asked Questions (F.A.Qs) & Answers

Q: Thanks for this fantastic work! Do you know any open source REST HTTP API for the World Factbook?

A: Not sure I understand your question ;-). factbook.json is a REST HTTP API for the World Factbook.

For example, to request the country profile (data) for Germany (gm) using the REST HTTP API ( - no API key required ;-) - ) try https://github.com/factbook/factbook.json/raw/master/europe/gm.json and so on.

Q: Why not just use the ISO country codes? Not a bug, a feature request.

A: The factbook has many more entities / countries than ISO and sometimes with a different definition - it's NOT an easy 1:1 mapping, see Cross-Reference List of Country Data Codes.

Q: I noticed that you've got Zambian data under ZA for the African region... It should be South African data...

A: See why not ISO codes - Uhhh... nevermind, I see it's stored under SF. Weird, but, ok :)

Q: Can you update the datasets?

A: Since August 2021 the datasets get auto-updated using / fetching the original online CIA World Factbook country profile datsets (cached in cache.factbook.json) weekly, that is, every Thursday. See the GitHub Actions log for details.

Q: The World Factbook front-page says "for 266 world entities" - but here I find only 260 (thus, 6 entities short)? What's the story?

The World Factbook provides basic intelligence on the history, people, government, economy, energy, geography, communications, transportation, military, terrorism, and transnational issues for 266 world entities.

(Source: cia.gov/the-world-factbook)

A: Since March 2006 the United States Pacific Island Wildlife Refuges (um) country profile consolidates seven profiles into a single new one (but keeps entities count as before):

  • Baker Island (fq)
  • Howland Island (hq)
  • Jarvis Island (dq)
  • Johnston Atoll (jq)
  • Kingman Reef (kq)
  • Midway Islands (mq)
  • Palmyra Atoll (lq)

Q: What happened to the Western Sahara (wi) country profile?

A: In December 2020 the World Factbook dropped coverage of the Western Sahara (wi). Why? In a deal with Morocco the United States recognizes the claim of Marocco over the Western Sahara and in return Morocco starts official diplomatic relations with Israel.

Code, Name,           Category,      Region
wi,   Western Sahara, Miscellaneous, Africa

Examples

Europe/Austria - au.json:

{
  "Introduction": {
    "Background": {
      "text": "Once the center of power for the large Austro-Hungarian Empire,
               Austria was reduced to a small republic after its defeat in World War..."
    }
  },
  "Geography": {
    "Location": {
      "text": "Central Europe, north of Italy and Slovenia"
    },
    "Geographic coordinates": {
      "text": "47 20 N, 13 20 E"
    },
    "Map references": {
      "text": "Europe"
    },
    "Area": {
      "total": {
        "text": "83,871 sq km"
      },
      "land": {
        "text": "82,445 sq km"
      },
      "water": {
        "text": "1,426 sq km"
      }
    },
    "Area - comparative": {
      "text": "about the size of South Carolina...",
    },
    "Land boundaries": {
      "total": {
        "text": "2,524 km"
      },
      "border countries": {
        "text": "Czech Republic 402 km, Germany 801 km, Hungary 321 km, Italy 404 km,
                 Liechtenstein 34 km, Slovakia 105 km, Slovenia 299 km, Switzerland 158 km"
      }
    },
    "Climate": {
      "text": "temperate; continental, cloudy; cold winters with frequent rain and
               some snow in lowlands and snow in mountains;
               moderate summers with occasional showers"
    },
    "Elevation": {
      "lowest point": {
        "text": "Neusiedler See 115 m"
      },
      "highest point": {
        "text": "Grossglockner 3,798 m"
      }
    },
    "Natural resources": {
      "text": "oil, coal, lignite, timber, iron ore, copper, zinc, antimony,
               magnesite, tungsten, graphite, salt, hydropower"
    },
    ...
}

The World Factbook Summary (266 260 Entries)

The World Factbook includes 266 260 entries - 195 sovereign countries / 2 others / 58 52 dependencies / 5 miscellaneous / 5 oceans / 1 world:

Sovereign Countries (195)

A af Afghanistan al Albania ag Algeria an Andorra ao Angola ac Antigua and Barbuda ar Argentina am Armenia as Australia au Austria aj Azerbaijan B bf The Bahamas ba Bahrain bg Bangladesh bb Barbados bo Belarus be Belgium bh Belize bn Benin bt Bhutan bl Bolivia bk Bosnia and Herzegovina bc Botswana br Brazil bx Brunei bu Bulgaria uv Burkina Faso bm Burma by Burundi C cb Cambodia cm Cameroon ca Canada cv Cape Verde ct Central African Republic cd Chad ci Chile ch China co Colombia cn Comoros cg Congo DR cf Congo cs Costa Rica iv Cote d'Ivoire hr Croatia cu Cuba cy Cyprus ez Czechia D da Denmark dj Djibouti do Dominica dr Dominican Republic E ec Ecuador eg Egypt es El Salvador ek Equatorial Guinea er Eritrea en Estonia wz Eswatini et Ethiopia F fj Fiji fi Finland fr France G gb Gabon ga The Gambia gg Georgia gm Germany gh Ghana gr Greece gj Grenada gt Guatemala gv Guinea pu Guinea-Bissau gy Guyana H ha Haiti ho Honduras hu Hungary I ic Iceland in India id Indonesia ir Iran iz Iraq ei Ireland is Israel it Italy J jm Jamaica ja Japan jo Jordan K kz Kazakhstan ke Kenya kr Kiribati kn North Korea ks South Korea kv Kosovo ku Kuwait kg Kyrgyzstan L la Laos lg Latvia le Lebanon lt Lesotho li Liberia ly Libya ls Liechtenstein lh Lithuania lu Luxembourg M ma Madagascar mi Malawi my Malaysia mv Maldives ml Mali mt Malta rm Marshall Islands mr Mauritania mp Mauritius mx Mexico fm Micronesia md Moldova mn Monaco mg Mongolia mj Montenegro mo Morocco mz Mozambique N wa Namibia nr Nauru np Nepal nl Netherlands nz New Zealand nu Nicaragua ng Niger ni Nigeria no Norway mk North Macedonia O mu Oman P pk Pakistan ps Palau pm Panama pp Papua New Guinea pa Paraguay pe Peru rp Philippines pl Poland po Portugal Q qa Qatar R ro Romania rs Russia rw Rwanda S sc Saint Kitts and Nevis st Saint Lucia vc Saint Vincent and the Grenadines ws Samoa sm San Marino tp Sao Tome and Principe sa Saudi Arabia sg Senegal ri Serbia se Seychelles sl Sierra Leone sn Singapore lo Slovakia si Slovenia bp Solomon Islands so Somalia sf South Africa od South Sudan sp Spain ce Sri Lanka su Sudan ns Suriname sw Sweden sz Switzerland sy Syria T ti Tajikistan tz Tanzania th Thailand tt Timor-Leste to Togo tn Tonga td Trinidad and Tobago ts Tunisia tu Turkey tx Turkmenistan tv Tuvalu U ug Uganda up Ukraine ae United Arab Emirates uk United Kingdom us United States uy Uruguay uz Uzbekistan V nh Vanuatu vt Vatican City (Holy See) ve Venezuela vm Vietnam Y ym Yemen Z za Zambia zi Zimbabwe

Other (2)

tw Taiwan ee European Union

Dependencies (52)

Australia (6): at Ashmore and Cartier Islands kt Christmas Island ck Cocos (Keeling) Islands cr Coral Sea Islands hm Heard Island and McDonald Islands nf Norfolk Island

China (2): hk Hong Kong mc Macau

Denmark (2): fo Faroe Islands gl Greenland

France (8): ip Clipperton Island fp French Polynesia fs French Southern and Antarctic Lands nc New Caledonia tb Saint Barthelemy rn Saint Martin sb Saint Pierre and Miquelon wf Wallis and Futuna

Netherlands (3): aa Aruba uc Curacao nn Sint Maarten

New Zealand (3): cw Cook Islands ne Niue tl Tokelau

Norway (3): bv Bouvet Island jn Jan Mayen sv Svalbard

United Kingdom (17): ax Akrotiri (Sovereign Base) av Anguilla bd Bermuda io British Indian Ocean Territory vi British Virgin Islands cj Cayman Islands dx Dhekelia (Sovereign Base) fk Falkland Islands gi Gibraltar gk Guernsey je Jersey im Isle of Man mh Montserrat pc Pitcairn Islands sh Saint Helena sx South Georgia and the South Sandwich Islands tk Turks and Caicos Islands

United States (14 8): aq American Samoa gq Guam bq Navassa Island cq Northern Mariana Islands rq Puerto Rico vq US Virgin Islands wq Wake Island um US Pacific Island Wildlife Refuges (Baker Island, Howland Island, Jarvis Island, Johnston Atoll, Kingman Reef, Midway Islands, Palmyra Atoll)

Miscellaneous (5)

ay Antarctica gz Gaza Strip pf Paracel Islands pg Spratly Islands we West Bank wi Western Sahara

Oceans (5)

xq Arctic Ocean zh Atlantic Ocean xo Indian Ocean zn Pacific Ocean oo Southern Ocean

World (1)

xx World

Build Your Own Up-to-Date Country Profiles

See the factbook command line tool and scripts for details.

Real-World Usage

Q: Anybody using these datasets? I don't know really. Add your project here - yes, you can!

Thomas Derflinger writes:

I used your JSON data files to import them into a Mongo database. Then I used Apollo to set up a GraphQL API in front of it. Using the project chi-country-facts (https://github.com/tderflinger/chi-country-facts) you can query World Factbook data comfortably using GraphQL (there also exists a web GraphQL playground). This enables easy data querying and extraction.

Another project of mine is Visual World Facts (https://visual-world-facts.pages.dev), where I try to visualize the World Factbook data in new ways. For example, I visualized the GDP by PPP of world countries with a treemap, which can lead to new insights.

License

The datasets and scripts are dedicated to the public domain. Use it as you please with no restrictions whatsoever.

Questions? Comments?

Send them along to the Open World Database (world.db) and Friends Forum/Mailing List. Thanks!