SANDAG provides a convenient, open API to its demographic data. From this API, developers and researchers can access demographic and housing data from all of the SANDAG population datasets.
The application uses modern RESTful URLs to access the data. The data is returned in easy to use JSON syntax. Go ahead, build your application today.
The data program from which to request information. Available options are census, estimate, forecast. Census data are a reflection
of the decennial census for the San Diego region. Estimates are developed annually and are a reflection of observed conditions. The
forecast is a most likely scenario of future events based on current demographic, economic, and policy trends in the region.
The year or series of the datasource requested. For a list of available years or series for each data type, use the select a datasoure
Census => datasurfer.sandag.org/api/census
Estimate => datasurfer.sandag.org/api/estimate
Forecast => datasurfer.sandag.org/api/forecast
The geography to aggregate the information. For a list of geographies available, poll the API for a particular combination of
datasource and year / series.
The available zone to aggregate for the selected datasource, year, and geography characteristics. For example, if you choose, Census 2010 by MSA,
the list would return all available MSA names.
The type of data that will be pulled based on the prior selections. Available options include: housing, age, ethnicity, income, and income/median.
For the forecast datasource, ethnicity/change and jobs are also available.
Housing => https://datasurfer.sandag.org/api/forecast/13/region/san diego/housing
Age => https://datasurfer.sandag.org/api/forecast/13/zip/92101/age
Ethnicity => https://datasurfer.sandag.org/api/estimate/2014/tract/1.00/ethnicity
Income => https://datasurfer.sandag.org/api/census/2000/elementary/solana beach/income
Median Income => https://datasurfer.sandag.org/api/estimate/2012/unified/san diego/income/median
(Forecast Only) Change in Ethnicity => https://datasurfer.sandag.org/api/forecast/12/zip/92103/ethnicity/change
(Forecast Only) Jobs => https://datasurfer.sandag.org/api/forecast/13/jurisdiction/coronado/jobs
SANDAG also provides the Excel (XLSX) and pre-formatted PDF exports of its population and housing data through the API. Using the following syntax you can request one or more geographies to be exported
directly to Excel or PDF.
PDF Export => https://datasurfer.sandag.org/api/<datasource>/<year>/<geography>/<zone>/<dataset+>/export/pdf
Excel Export => https://datasurfer.sandag.org/api/<datasource>/<year>/<geography>/<zone>/<dataset+>/export/xlsx
Area Mapping (GeoJSON)
The current version of Data Surfer uses a Slippy map to render the geographic boundaries of a zone. The map uses a Leaflet base map and a geojson API call to generate the zone shape.
Area Map Images (Static)
In case you need a context map image for your application, the API provides static map images of all geography zones included in the API.