XML feed
Contents
The NationStates XML feed
The XML feed is provided to NationStates players as a fast and convenient source for basic data about nations and regions, without having to derive it from the main pages. It is available to XML-enabled applications such as GDP Calculators, which can provide players with a quick and convenient source for information about the game.
It should be noted that the XML feed specifically does not include a large number of the game's national statistics variables. This was a conscious decision by Max Barry and the Mods, as too much information has the potential to make the game less fun. The feed is accurate, but should not be considered complete.
Some players have been known to use scripts to collect XML regional and national information and store it for future reference. A number of interesting conclusions can be reached by careful comparison of dated XML feeds. This is considered legal, but not definitive, in-game information, as it can be easily edited outside the game.
National XML feed
To access this feed, take the following URL and paste it into your browser window and change 'YourNation' to whichever nation you would like to see.
http://www.nationstates.net/cgi-bin/nationdata.cgi/nation=YourNation
National Feed example
<?xml version="1.0" ?> -<NATIONINFO> <NAME> nation </NAME> <TYPE> national title </TYPE> <FULLNAME> Fully qualified name </FULLNAME> <MOTTO> Your motto goes here! </MOTTO> <CATEGORY> UN Category </CATEGORY> <UNSTATUS> UN Delegate </UNSTATUS> -<FREEDOM> <CIVILRIGHTS> Civil Rights Rating </CIVILRIGHTS> <ECONOMY> Economy Rating </ECONOMY> <POLITICALFREEDOM> Political Freedom Rating </POLITICALFREEDOM> </FREEDOM> <REGION> Region </REGION> <POPULATION> Population in millions </POPULATION> <TAX> Tax percentage </TAX> <ANIMAL> National Animal </ANIMAL> <CURRENCY> National Currency </CURRENCY> <FLAG> URL for flag </FLAG> <MAJORINDUSTRY> Major Industry </MAJORINDUSTRY> <GOVTPRIORITY> Government Spending priority </GOVTPRIORITY> -<GOVT> <ADMINISTRATION> % of Government spending </ADMINISTRATION> <WELFARE> % of Government spending </WELFARE> <HEALTHCARE> % of Government spending </HEALTHCARE> <EDUCATION> % of Government spending </EDUCATION> <SPIRITUALITY> % of Government spending </SPIRITUALITY> <DEFENCE> % of Government spending </DEFENCE> <LAWANDORDER> % of Government spending </LAWANDORDER> <COMMERCE> % of Government spending </COMMERCE> <PUBLICTRANSPORT> % of Government spending </PUBLICTRANSPORT> <ENVIRONMENT> % of Government spending </ENVIRONMENT> <SOCIALEQUALITY> % of Government spending </SOCIALEQUALITY> </GOVT> <FOUNDED> time in minutes, hours, or days </FOUNDED> <FIRSTLOGIN> seconds since 1 January 1970, 00:00:00 UTC at founding date </FIRSTLOGIN> <LASTLOGIN> seconds since 1 January 1970, 00:00:00 UTC at last login </LASTLOGIN> <LASTACTIVITY> time in minutes, hours, or days </LASTACTIVITY> </NATIONINFO>
Note that older nations don't have the <FIRSTLOGIN> and <FOUNDED> statistics.
Regional XML feed
To access this feed, take the following URL and paste it into your browser window and change 'YourRegion' to whichever region you would like to see.
http://www.nationstates.net/cgi-bin/regiondata.cgi/region=YourRegion
Regional Feed example
<?xml version="1.0" ?> -<REGIONINFO> <NAME> region </NAME> <FACTBOOK> The text of the World Factbook entry </FACTBOOK> <NUMNATIONS> number of nations present in the region </NUMNATIONS> <NATIONS> nation1 : nation2 : nation3 : nation4 </NATIONS> <DELEGATE> UN Delegate </DELEGATE> <DELEGATEVOTES> number of votes the Delegate gets </DELEGATEVOTES> <FOUNDER> Founder </FOUNDER> </REGIONINFO>