DeveloperAPI » Provider Statistics API - Provider Within A State
Description
This API returns broadband summary data for a particular provider within a state. The data includes demographics, states in which the provider is available, different technologies and broadband speeds reported in the particular area being searched for on a scale of 0 to 1.
Latest data version released jun2012. Previous data versions include jun2011, dec2011.
Why We Provide It
We are providing this API to increase the value of the transparency of the National Broadband Map. With this API you now have access to statewide provider statistics.
Review Data Dictionary
JSON XML
API Base
http://www.broadbandmap.gov/broadbandmap/
API Call
{API Base}/provider/{dataVersion}/stats/state/{stateId}/{censusMetric}/{holdingCompanyNumber}?format={format}&callback={functionName}
Sample Call
http://www.broadbandmap.gov/broadbandmap/provider/jun2012/stats/state/01/population/130077?format=json
Required Parameters
dataVersion:
specify the data version for search(no defaults). Examples: jun2012, dec2011, jun2011.
{stateId}:
specify the state id in which the provider statistics needs to be retrieved. Use Geography lookup API by geography type (state) to retrieve the state ids.
{censusMetric}:
specify the census metric by which the data has to be aggregated. It can be only population as of now.
{holdingCompanyNumber}:
specify the holding company number of the provider using Provider by Geography API.
Optional Parameters
format:
XML, JSON, JSONP (XML is default)
callback:
JSONP callback function name
{
"status":"OK",
"responseTime":5,
"message":[
],
"Results":{
"providerStatistics":{
"geographyName":"Alabama",
"holdingCompanyName":"AT&T Inc.",
"landArea":34492.89240000,
"population":4712652,
"populationDensity":100,
"households":2142708,
"raceWhite":0.70640,
"raceBlack":0.25510,
"raceHispanic":0.02920,
"raceAsian":0.00740,
"raceNativeAmerican":0.00190,
"incomeBelowPoverty":0.18890,
"medianIncome":47142.33210,
"incomeLessThan25":0.30720,
"incomeBetween25to50":0.32850,
"incomeBetween50to100":0.28410,
"incomeBetween100to200":0.12200,
"incomeGreater200":0.02350,
"educationHighSchoolGraduate":0.76490,
"educationBachelorOrGreater":0.20540,
"ageUnder5":0.04920,
"ageBetween5to19":0.20470,
"ageBetween20to34":0.20110,
"ageBetween35to59":0.33700,
"ageGreaterThan60":0.20800,
"wirelineDownloadSpeedGreaterThan768k":0.58680,
"wirelineDownloadSpeedGreaterThan1500k":0.57430,
"wirelineDownloadSpeedGreaterThan3000k":0.46250,
"wirelineDownloadSpeedGreaterThan6000k":0.42050,
"wirelineDownloadSpeedGreaterThan10000k":0.34030,
"wirelineDownloadSpeedGreaterThan25000k":0.00000,
"wirelineDownloadSpeedGreaterThan50000k":0.00000,
"wirelineDownloadSpeedGreaterThan100000k":0.00000,
"wirelineDownloadSpeedGreaterThan1Gig":0.00000,
"wirelineUploadSpeedLessThan200k":0.00000,
"wirelineUploadSpeedGreaterThan200k":0.58680,
"wirelineUploadSpeedGreaterThan768k":0.42050,
"wirelineUploadSpeedGreaterThan1500k":0.26730,
"wirelineUploadSpeedGreaterThan3000k":0.02870,
"wirelineUploadSpeedGreaterThan6000k":0.00000,
"wirelineUploadSpeedGreaterThan10000k":0.00000,
"wirelineUploadSpeedGreaterThan25000k":0.00000,
"wirelineUploadSpeedGreaterThan50000k":0.00000,
"wirelineUploadSpeedGreaterThan100000k":0.00000,
"wirelineUploadSpeedGreaterThan1Gig":0.00000,
"wirelineDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k":0.58680,
"wirelineDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k":0.42050,
"wirelessDownloadSpeedGreaterThan768k":0.96630,
"wirelessDownloadSpeedGreaterThan1500k":0.96630,
"wirelessDownloadSpeedGreaterThan3000k":0.91410,
"wirelessDownloadSpeedGreaterThan6000k":0.00000,
"wirelessDownloadSpeedGreaterThan10000k":0.00000,
"wirelessDownloadSpeedGreaterThan25000k":0.00000,
"wirelessDownloadSpeedGreaterThan50000k":0.00000,
"wirelessDownloadSpeedGreaterThan100000k":0.00000,
"wirelessDownloadSpeedGreaterThan1Gig":0.00000,
"wirelessUploadSpeedLessThan200k":0.00000,
"wirelessUploadSpeedGreaterThan200k":0.96630,
"wirelessUploadSpeedGreaterThan768k":0.96630,
"wirelessUploadSpeedGreaterThan1500k":0.91410,
"wirelessUploadSpeedGreaterThan3000k":0.91410,
"wirelessUploadSpeedGreaterThan6000k":0.00000,
"wirelessUploadSpeedGreaterThan10000k":0.00000,
"wirelessUploadSpeedGreaterThan25000k":0.00000,
"wirelessUploadSpeedGreaterThan50000k":0.00000,
"wirelessUploadSpeedGreaterThan100000k":0.00000,
"wirelessUploadSpeedGreaterThan1Gig":0.00000,
"wirelessDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k":0.96630,
"wirelessDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k":0.91410,
"anyTechnology":0.97240,
"anyWireline":0.58680,
"dsl":0.58660,
"asymmetricDsl":0.58660,
"symmetricDsl":0.00000,
"copper":0.00000,
"cable":0.00000,
"cableDocsis":0.00000,
"cableOther":0.00000,
"opticalFiber":0.00020,
"powerline":0.00000,
"anyWireless":0.96630,
"satellite":0.00000,
"fixedWireless":0.00000,
"fixedWirelessUnlicensed":0.00000,
"fixedWirelessLicensed":0.00000,
"mobileWireless":0.96630,
"otherTechnology":0.00000,
"mostCommonDownloadSpeed":3.00000,
"mostCommonDownloadSpeedPercentage":0.97240,
"greatestDownloadSpeed":7.00000,
"greatestDownloadSpeedPercentage":0.34030,
"mostCommonUploadSpeed":2.00000,
"mostCommonUploadSpeedPercentage":0.97240,
"greatestUploadSpeed":5.00000,
"greatestUploadSpeedPercentage":0.91410
},
"statesServedByProvider":[
"01",
"02",
"04",
"05",
"06",
"08",
"09",
"10",
"11",
"12",
"13",
"15",
"16",
"17",
"18",
"19",
"20",
"21",
"22",
"23",
"24",
"25",
"26",
"27",
"28",
"29",
"30",
"31",
"32",
"33",
"34",
"35",
"36",
"37",
"38",
"39",
"40",
"41",
"42",
"44",
"45",
"46",
"47",
"48",
"49",
"50",
"51",
"53",
"54",
"55",
"56",
"72",
"78"
]
}
}
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Response status="OK" responseTime="5">
<Results>
<providerStatistics>
<geographyName>Alabama</geographyName>
<holdingCompanyName>AT&T Inc.</holdingCompanyName>
<landArea>34492.89240000</landArea>
<population>4712652</population>
<populationDensity>100</populationDensity>
<households>2142708</households>
<raceWhite>0.70640</raceWhite>
<raceBlack>0.25510</raceBlack>
<raceHispanic>0.02920</raceHispanic>
<raceAsian>0.00740</raceAsian>
<raceNativeAmerican>0.00190</raceNativeAmerican>
<incomeBelowPoverty>0.18890</incomeBelowPoverty>
<medianIncome>47142.33210</medianIncome>
<incomeLessThan25>0.30720</incomeLessThan25>
<incomeBetween25to50>0.32850</incomeBetween25to50>
<incomeBetween50to100>0.28410</incomeBetween50to100>
<incomeBetween100to200>0.12200</incomeBetween100to200>
<incomeGreater200>0.02350</incomeGreater200>
<educationHighSchoolGraduate>0.76490</educationHighSchoolGraduate>
<educationBachelorOrGreater>0.20540</educationBachelorOrGreater>
<ageUnder5>0.04920</ageUnder5>
<ageBetween5to19>0.20470</ageBetween5to19>
<ageBetween20to34>0.20110</ageBetween20to34>
<ageBetween35to59>0.33700</ageBetween35to59>
<ageGreaterThan60>0.20800</ageGreaterThan60>
<wirelineDownloadSpeedGreaterThan768k>0.58680</wirelineDownloadSpeedGreaterThan768k>
<wirelineDownloadSpeedGreaterThan1500k>0.57430</wirelineDownloadSpeedGreaterThan1500k>
<wirelineDownloadSpeedGreaterThan3000k>0.46250</wirelineDownloadSpeedGreaterThan3000k>
<wirelineDownloadSpeedGreaterThan6000k>0.42050</wirelineDownloadSpeedGreaterThan6000k>
<wirelineDownloadSpeedGreaterThan10000k>0.34030</wirelineDownloadSpeedGreaterThan10000k>
<wirelineDownloadSpeedGreaterThan25000k>0.00000</wirelineDownloadSpeedGreaterThan25000k>
<wirelineDownloadSpeedGreaterThan50000k>0.00000</wirelineDownloadSpeedGreaterThan50000k>
<wirelineDownloadSpeedGreaterThan100000k>0.00000</wirelineDownloadSpeedGreaterThan100000k>
<wirelineDownloadSpeedGreaterThan1Gig>0.00000</wirelineDownloadSpeedGreaterThan1Gig>
<wirelineUploadSpeedLessThan200k>0.00000</wirelineUploadSpeedLessThan200k>
<wirelineUploadSpeedGreaterThan200k>0.58680</wirelineUploadSpeedGreaterThan200k>
<wirelineUploadSpeedGreaterThan768k>0.42050</wirelineUploadSpeedGreaterThan768k>
<wirelineUploadSpeedGreaterThan1500k>0.26730</wirelineUploadSpeedGreaterThan1500k>
<wirelineUploadSpeedGreaterThan3000k>0.02870</wirelineUploadSpeedGreaterThan3000k>
<wirelineUploadSpeedGreaterThan6000k>0.00000</wirelineUploadSpeedGreaterThan6000k>
<wirelineUploadSpeedGreaterThan10000k>0.00000</wirelineUploadSpeedGreaterThan10000k>
<wirelineUploadSpeedGreaterThan25000k>0.00000</wirelineUploadSpeedGreaterThan25000k>
<wirelineUploadSpeedGreaterThan50000k>0.00000</wirelineUploadSpeedGreaterThan50000k>
<wirelineUploadSpeedGreaterThan100000k>0.00000</wirelineUploadSpeedGreaterThan100000k>
<wirelineUploadSpeedGreaterThan1Gig>0.00000</wirelineUploadSpeedGreaterThan1Gig>
<wirelineDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k>0.58680</wirelineDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k>
<wirelineDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k>0.42050</wirelineDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k>
<wirelessDownloadSpeedGreaterThan768k>0.96630</wirelessDownloadSpeedGreaterThan768k>
<wirelessDownloadSpeedGreaterThan1500k>0.96630</wirelessDownloadSpeedGreaterThan1500k>
<wirelessDownloadSpeedGreaterThan3000k>0.91410</wirelessDownloadSpeedGreaterThan3000k>
<wirelessDownloadSpeedGreaterThan6000k>0.00000</wirelessDownloadSpeedGreaterThan6000k>
<wirelessDownloadSpeedGreaterThan10000k>0.00000</wirelessDownloadSpeedGreaterThan10000k>
<wirelessDownloadSpeedGreaterThan25000k>0.00000</wirelessDownloadSpeedGreaterThan25000k>
<wirelessDownloadSpeedGreaterThan50000k>0.00000</wirelessDownloadSpeedGreaterThan50000k>
<wirelessDownloadSpeedGreaterThan100000k>0.00000</wirelessDownloadSpeedGreaterThan100000k>
<wirelessDownloadSpeedGreaterThan1Gig>0.00000</wirelessDownloadSpeedGreaterThan1Gig>
<wirelessUploadSpeedLessThan200k>0.00000</wirelessUploadSpeedLessThan200k>
<wirelessUploadSpeedGreaterThan200k>0.96630</wirelessUploadSpeedGreaterThan200k>
<wirelessUploadSpeedGreaterThan768k>0.96630</wirelessUploadSpeedGreaterThan768k>
<wirelessUploadSpeedGreaterThan1500k>0.91410</wirelessUploadSpeedGreaterThan1500k>
<wirelessUploadSpeedGreaterThan3000k>0.91410</wirelessUploadSpeedGreaterThan3000k>
<wirelessUploadSpeedGreaterThan6000k>0.00000</wirelessUploadSpeedGreaterThan6000k>
<wirelessUploadSpeedGreaterThan10000k>0.00000</wirelessUploadSpeedGreaterThan10000k>
<wirelessUploadSpeedGreaterThan25000k>0.00000</wirelessUploadSpeedGreaterThan25000k>
<wirelessUploadSpeedGreaterThan50000k>0.00000</wirelessUploadSpeedGreaterThan50000k>
<wirelessUploadSpeedGreaterThan100000k>0.00000</wirelessUploadSpeedGreaterThan100000k>
<wirelessUploadSpeedGreaterThan1Gig>0.00000</wirelessUploadSpeedGreaterThan1Gig>
<wirelessDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k>0.96630</wirelessDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k>
<wirelessDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k>0.91410</wirelessDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k>
<anyTechnology>0.97240</anyTechnology>
<anyWireline>0.58680</anyWireline>
<dsl>0.58660</dsl>
<asymmetricDsl>0.58660</asymmetricDsl>
<symmetricDsl>0.00000</symmetricDsl>
<copper>0.00000</copper>
<cable>0.00000</cable>
<cableDocsis>0.00000</cableDocsis>
<cableOther>0.00000</cableOther>
<opticalFiber>0.00020</opticalFiber>
<powerline>0.00000</powerline>
<anyWireless>0.96630</anyWireless>
<satellite>0.00000</satellite>
<fixedWireless>0.00000</fixedWireless>
<fixedWirelessUnlicensed>0.00000</fixedWirelessUnlicensed>
<fixedWirelessLicensed>0.00000</fixedWirelessLicensed>
<mobileWireless>0.96630</mobileWireless>
<otherTechnology>0.00000</otherTechnology>
<mostCommonDownloadSpeed>3.00000</mostCommonDownloadSpeed>
<mostCommonDownloadSpeedPercentage>0.97240</mostCommonDownloadSpeedPercentage>
<greatestDownloadSpeed>7.00000</greatestDownloadSpeed>
<greatestDownloadSpeedPercentage>0.34030</greatestDownloadSpeedPercentage>
<mostCommonUploadSpeed>2.00000</mostCommonUploadSpeed>
<mostCommonUploadSpeedPercentage>0.97240</mostCommonUploadSpeedPercentage>
<greatestUploadSpeed>5.00000</greatestUploadSpeed>
<greatestUploadSpeedPercentage>0.91410</greatestUploadSpeedPercentage>
</providerStatistics>
<statesServedByProvider>01</statesServedByProvider>
<statesServedByProvider>02</statesServedByProvider>
<statesServedByProvider>04</statesServedByProvider>
<statesServedByProvider>05</statesServedByProvider>
<statesServedByProvider>06</statesServedByProvider>
<statesServedByProvider>08</statesServedByProvider>
<statesServedByProvider>09</statesServedByProvider>
<statesServedByProvider>10</statesServedByProvider>
<statesServedByProvider>11</statesServedByProvider>
<statesServedByProvider>12</statesServedByProvider>
<statesServedByProvider>13</statesServedByProvider>
<statesServedByProvider>15</statesServedByProvider>
<statesServedByProvider>16</statesServedByProvider>
<statesServedByProvider>17</statesServedByProvider>
<statesServedByProvider>18</statesServedByProvider>
<statesServedByProvider>19</statesServedByProvider>
<statesServedByProvider>20</statesServedByProvider>
<statesServedByProvider>21</statesServedByProvider>
<statesServedByProvider>22</statesServedByProvider>
<statesServedByProvider>23</statesServedByProvider>
<statesServedByProvider>24</statesServedByProvider>
<statesServedByProvider>25</statesServedByProvider>
<statesServedByProvider>26</statesServedByProvider>
<statesServedByProvider>27</statesServedByProvider>
<statesServedByProvider>28</statesServedByProvider>
<statesServedByProvider>29</statesServedByProvider>
<statesServedByProvider>30</statesServedByProvider>
<statesServedByProvider>31</statesServedByProvider>
<statesServedByProvider>32</statesServedByProvider>
<statesServedByProvider>33</statesServedByProvider>
<statesServedByProvider>34</statesServedByProvider>
<statesServedByProvider>35</statesServedByProvider>
<statesServedByProvider>36</statesServedByProvider>
<statesServedByProvider>37</statesServedByProvider>
<statesServedByProvider>38</statesServedByProvider>
<statesServedByProvider>39</statesServedByProvider>
<statesServedByProvider>40</statesServedByProvider>
<statesServedByProvider>41</statesServedByProvider>
<statesServedByProvider>42</statesServedByProvider>
<statesServedByProvider>44</statesServedByProvider>
<statesServedByProvider>45</statesServedByProvider>
<statesServedByProvider>46</statesServedByProvider>
<statesServedByProvider>47</statesServedByProvider>
<statesServedByProvider>48</statesServedByProvider>
<statesServedByProvider>49</statesServedByProvider>
<statesServedByProvider>50</statesServedByProvider>
<statesServedByProvider>51</statesServedByProvider>
<statesServedByProvider>53</statesServedByProvider>
<statesServedByProvider>54</statesServedByProvider>
<statesServedByProvider>55</statesServedByProvider>
<statesServedByProvider>56</statesServedByProvider>
<statesServedByProvider>72</statesServedByProvider>
<statesServedByProvider>78</statesServedByProvider>
</Results>
</Response>