At its core, the Data USA API allows users to show data across various levels of detail, called sumlevels. There are four core categories of data: geographies, occupations, industries and educational studies. This page illustrates an example usage of exploring geographic data. Full documentation for the Data USA API is available on the Github repository wiki.

The data section of the JSON result contains a list of rows of data. Each header represents the respective data element in each row. For example, 2013 the first item in the first row, represents a "year" since year is the first item in the header array.

The previous API call will return data for all available years in the database. To only retrieve the latest year’s data, use:

You may have noticed some additional pieces of information returned with each API call. The logic section represents the list of possible data sources the API could use to fulfill a given request. The logic section is a list of dictionaries with information on each possible data table.

The subs section will indicate whether any input variables have been substituted for purposes of providing data (instead of providing no data). If the subs dictionary is empty, then no subsitutions have been made.