XML feed

From NSwiki, the NationStates encyclopedia.
Jump to: navigation, search

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>