DeveloperAPI » Demographics API - By Geography Type And Geography ID
Description
This API allows the user to search for the demographic information for a particular geography type and geography ID.
Please note: TimeSeries Fall2010 and Dec2010 are no longer available. Use /jun2011/
Why We Provide It
We are providing this API to increase the value of the transparency of the National Broadband Map. With this API users can search for and return demographic information for a particular geography type (e.g., state, congressional district) and geography ID.
Review Data Dictionary
JSON XML
API Base
http://www.broadbandmap.gov/broadbandmap/
API Call
{API Base}/demographic/{dataVersion}/{geographyType}/ids/{geographyIds}?format={format}&callback={functionName}//
Sample Call
http://www.broadbandmap.gov/broadbandmap/demographic/jun2011/county/ids/17081,17083?format=json
Required Parameters
dataVersion:
specify the data version for search(no defaults). Examples: jun2011
geographyType:
specify one of the following geography type: censusplace, msa, usf, county, statesenate, statehouse, congdistrict
geographyIds:
specify the geography IDs to search for separated by commas and a maximum of 10 are allowed
Optional Parameters
format (optional):
XML, JSON, JSONP (XML is default)
callback (optional)
JSONP callback function name
{
"status":"OK",
"responseTime":22,
"message":[
],
"Results":[
{
"geographyId":"17081",
"geographyName":"Jefferson",
"landArea":532.78987560,
"population":38804,
"households":16946,
"raceWhite":0.88200,
"raceBlack":0.08470,
"raceHispanic":0.02460,
"raceAsian":0.00640,
"raceNativeAmerican":0.00220,
"incomeBelowPoverty":0.17000,
"medianIncome":41875.73320,
"incomeLessThan25":0.36460,
"incomeBetween25to50":0.34000,
"incomeBetween50to100":0.24410,
"incomeBetween100to200":0.04190,
"incomeGreater200":0.00940,
"educationHighSchoolGraduate":0.77470,
"educationBachelorOrGreater":0.13950,
"ageUnder5":0.04690,
"ageBetween5to19":0.18650,
"ageBetween20to34":0.18220,
"ageBetween35to59":0.32620,
"ageGreaterThan60":0.25820,
"myAreaIndicator":false
},
{
"geographyId":"17083",
"geographyName":"Jersey",
"landArea":356.86880601,
"population":23090,
"households":9877,
"raceWhite":0.97550,
"raceBlack":0.00400,
"raceHispanic":0.01430,
"raceAsian":0.00340,
"raceNativeAmerican":0.00260,
"incomeBelowPoverty":0.10000,
"medianIncome":51645.76710,
"incomeLessThan25":0.28260,
"incomeBetween25to50":0.31390,
"incomeBetween50to100":0.32660,
"incomeBetween100to200":0.06320,
"incomeGreater200":0.01370,
"educationHighSchoolGraduate":0.82400,
"educationBachelorOrGreater":0.13140,
"ageUnder5":0.04560,
"ageBetween5to19":0.19330,
"ageBetween20to34":0.19910,
"ageBetween35to59":0.32500,
"ageGreaterThan60":0.23690,
"myAreaIndicator":false
}
]
}
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Response status="OK" responseTime="25">
<Results myAreaIndicator="false">
<landArea>532.78987560</landArea>
<population>38804</population>
<households>16946</households>
<raceWhite>0.88200</raceWhite>
<raceBlack>0.08470</raceBlack>
<raceHispanic>0.02460</raceHispanic>
<raceAsian>0.00640</raceAsian>
<raceNativeAmerican>0.00220</raceNativeAmerican>
<incomeBelowPoverty>0.17000</incomeBelowPoverty>
<medianIncome>41875.73320</medianIncome>
<incomeLessThan25>0.36460</incomeLessThan25>
<incomeBetween25to50>0.34000</incomeBetween25to50>
<incomeBetween50to100>0.24410</incomeBetween50to100>
<incomeBetween100to200>0.04190</incomeBetween100to200>
<incomeGreater200>0.00940</incomeGreater200>
<educationHighSchoolGraduate>0.77470</educationHighSchoolGraduate>
<educationBachelorOrGreater>0.13950</educationBachelorOrGreater>
<ageUnder5>0.04690</ageUnder5>
<ageBetween5to19>0.18650</ageBetween5to19>
<ageBetween20to34>0.18220</ageBetween20to34>
<ageBetween35to59>0.32620</ageBetween35to59>
<ageGreaterThan60>0.25820</ageGreaterThan60>
<geographyId>17081</geographyId>
<geographyName>Jefferson</geographyName>
</Results>
<Results myAreaIndicator="false">
<landArea>356.86880601</landArea>
<population>23090</population>
<households>9877</households>
<raceWhite>0.97550</raceWhite>
<raceBlack>0.00400</raceBlack>
<raceHispanic>0.01430</raceHispanic>
<raceAsian>0.00340</raceAsian>
<raceNativeAmerican>0.00260</raceNativeAmerican>
<incomeBelowPoverty>0.10000</incomeBelowPoverty>
<medianIncome>51645.76710</medianIncome>
<incomeLessThan25>0.28260</incomeLessThan25>
<incomeBetween25to50>0.31390</incomeBetween25to50>
<incomeBetween50to100>0.32660</incomeBetween50to100>
<incomeBetween100to200>0.06320</incomeBetween100to200>
<incomeGreater200>0.01370</incomeGreater200>
<educationHighSchoolGraduate>0.82400</educationHighSchoolGraduate>
<educationBachelorOrGreater>0.13140</educationBachelorOrGreater>
<ageUnder5>0.04560</ageUnder5>
<ageBetween5to19>0.19330</ageBetween5to19>
<ageBetween20to34>0.19910</ageBetween20to34>
<ageBetween35to59>0.32500</ageBetween35to59>
<ageGreaterThan60>0.23690</ageGreaterThan60>
<geographyId>17083</geographyId>
<geographyName>Jersey</geographyName>
</Results>
</Response>