Developer

API » Provider Statistics API - Provider Within A Geography


Description
This API returns broadband summary data for a particular provider within Geography. 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 jun2014. Previous data versions include jun2011, dec2011, jun2012, dec2012, jun2013, dec2013.

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 provider statistics within the geography.

Review Data Dictionary

JSON   XML

API Base
https://www.broadbandmap.gov/broadbandmap/

API Call
{API Base}/provider/{dataVersion}/stats/state/{stateId}/{censusMetric}/{geographyType}/{geographyId}/{holdingCompanyNumber}?format={format}&callback={functionName}

Sample Call
https://www.broadbandmap.gov/broadbandmap/provider/jun2014/stats/state/01/population/congdistrict/0111301/130077?format=json

Required Parameters
dataVersion:
specify the data version for search(no defaults). Examples: jun2014, dec2013, jun2013, dec2012, 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.

{geographyType}:
specify either one of the following geography type: county, censusplace, msa, usf, statesenate, statehouse, congdistrict, tribalnation.

{geographyId}:
specify the geography id in which the provider statistics needs to be retrieved. Use Geography lookup API by geography type to retrieve geography ids. For Tribal Nation, use 99 as stateId.

{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

Response

JSON   XML

{
 "status":"OK",
 "responseTime":17,
 "message":[
  
 ],
 "Results":{
  "providerStatistics":{
   "geographyName":"01",
   "holdingCompanyName":"AT&T Inc.",
   "landArea":4311.54080000,
   "population":709329,
   "populationDensity":117,
   "households":331327,
   "raceWhite":0.68970,
   "raceBlack":0.26830,
   "raceHispanic":0.02630,
   "raceAsian":0.00940,
   "raceNativeAmerican":0.00630,
   "incomeBelowPoverty":0.18630,
   "medianIncome":47978.38490,
   "incomeLessThan25":0.29400,
   "incomeBetween25to50":0.26260,
   "incomeBetween50to100":0.29870,
   "incomeBetween100to200":0.11740,
   "incomeGreater200":0.02730,
   "educationHighSchoolGraduate":0.78280,
   "educationBachelorOrGreater":0.19150,
   "ageUnder5":0.05730,
   "ageBetween5to19":0.21320,
   "ageBetween20to34":0.19910,
   "ageBetween35to59":0.31840,
   "ageGreaterThan60":0.21210,
   "wirelineDownloadSpeedGreaterThan768k":0.66350,
   "wirelineDownloadSpeedGreaterThan1500k":0.64940,
   "wirelineDownloadSpeedGreaterThan3000k":0.58750,
   "wirelineDownloadSpeedGreaterThan6000k":0.55670,
   "wirelineDownloadSpeedGreaterThan10000k":0.51370,
   "wirelineDownloadSpeedGreaterThan25000k":0.02340,
   "wirelineDownloadSpeedGreaterThan50000k":0.00000,
   "wirelineDownloadSpeedGreaterThan100000k":0.00000,
   "wirelineDownloadSpeedGreaterThan1Gig":0.00000,
   "wirelineUploadSpeedLessThan200k":0.00000,
   "wirelineUploadSpeedGreaterThan200k":0.66350,
   "wirelineUploadSpeedGreaterThan768k":0.55670,
   "wirelineUploadSpeedGreaterThan1500k":0.47000,
   "wirelineUploadSpeedGreaterThan3000k":0.03220,
   "wirelineUploadSpeedGreaterThan6000k":0.02340,
   "wirelineUploadSpeedGreaterThan10000k":0.00000,
   "wirelineUploadSpeedGreaterThan25000k":0.00000,
   "wirelineUploadSpeedGreaterThan50000k":0.00000,
   "wirelineUploadSpeedGreaterThan100000k":0.00000,
   "wirelineUploadSpeedGreaterThan1Gig":0.00000,
   "wirelineDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k":0.66350,
   "wirelineDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k":0.55670,
   "wirelessDownloadSpeedGreaterThan768k":0.99010,
   "wirelessDownloadSpeedGreaterThan1500k":0.99010,
   "wirelessDownloadSpeedGreaterThan3000k":0.99000,
   "wirelessDownloadSpeedGreaterThan6000k":0.94640,
   "wirelessDownloadSpeedGreaterThan10000k":0.94640,
   "wirelessDownloadSpeedGreaterThan25000k":0.00000,
   "wirelessDownloadSpeedGreaterThan50000k":0.00000,
   "wirelessDownloadSpeedGreaterThan100000k":0.00000,
   "wirelessDownloadSpeedGreaterThan1Gig":0.00000,
   "wirelessUploadSpeedLessThan200k":0.00000,
   "wirelessUploadSpeedGreaterThan200k":0.99010,
   "wirelessUploadSpeedGreaterThan768k":0.99010,
   "wirelessUploadSpeedGreaterThan1500k":0.99000,
   "wirelessUploadSpeedGreaterThan3000k":0.94640,
   "wirelessUploadSpeedGreaterThan6000k":0.00000,
   "wirelessUploadSpeedGreaterThan10000k":0.00000,
   "wirelessUploadSpeedGreaterThan25000k":0.00000,
   "wirelessUploadSpeedGreaterThan50000k":0.00000,
   "wirelessUploadSpeedGreaterThan100000k":0.00000,
   "wirelessUploadSpeedGreaterThan1Gig":0.00000,
   "wirelessDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k":0.99010,
   "wirelessDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k":0.99000,
   "anyTechnology":0.99260,
   "anyWireline":0.66350,
   "dsl":0.66080,
   "asymmetricDsl":0.66080,
   "symmetricDsl":0.00000,
   "copper":0.00000,
   "cable":0.00000,
   "cableDocsis":0.00000,
   "cableOther":0.00000,
   "opticalFiber":0.00270,
   "powerline":0.00000,
   "anyWireless":0.99010,
   "satellite":0.00000,
   "fixedWireless":0.00000,
   "fixedWirelessUnlicensed":0.00000,
   "fixedWirelessLicensed":0.00000,
   "mobileWireless":0.99010,
   "otherTechnology":0.00000,
   "mostCommonDownloadSpeed":3.00000,
   "mostCommonDownloadSpeedPercentage":0.99260,
   "greatestDownloadSpeed":8.00000,
   "greatestDownloadSpeedPercentage":0.02340,
   "mostCommonUploadSpeed":2.00000,
   "mostCommonUploadSpeedPercentage":0.99260,
   "greatestUploadSpeed":6.00000,
   "greatestUploadSpeedPercentage":0.02340
  },
  "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="11">
  <Results>
    <providerStatistics>
      <geographyName>01</geographyName>
      <holdingCompanyName>AT&amp;T Inc.</holdingCompanyName>
      <landArea>4311.54080000</landArea>
      <population>709329</population>
      <populationDensity>117</populationDensity>
      <households>331327</households>
      <raceWhite>0.68970</raceWhite>
      <raceBlack>0.26830</raceBlack>
      <raceHispanic>0.02630</raceHispanic>
      <raceAsian>0.00940</raceAsian>
      <raceNativeAmerican>0.00630</raceNativeAmerican>
      <incomeBelowPoverty>0.18630</incomeBelowPoverty>
      <medianIncome>47978.38490</medianIncome>
      <incomeLessThan25>0.29400</incomeLessThan25>
      <incomeBetween25to50>0.26260</incomeBetween25to50>
      <incomeBetween50to100>0.29870</incomeBetween50to100>
      <incomeBetween100to200>0.11740</incomeBetween100to200>
      <incomeGreater200>0.02730</incomeGreater200>
      <educationHighSchoolGraduate>0.78280</educationHighSchoolGraduate>
      <educationBachelorOrGreater>0.19150</educationBachelorOrGreater>
      <ageUnder5>0.05730</ageUnder5>
      <ageBetween5to19>0.21320</ageBetween5to19>
      <ageBetween20to34>0.19910</ageBetween20to34>
      <ageBetween35to59>0.31840</ageBetween35to59>
      <ageGreaterThan60>0.21210</ageGreaterThan60>
      <wirelineDownloadSpeedGreaterThan768k>0.66350</wirelineDownloadSpeedGreaterThan768k>
      <wirelineDownloadSpeedGreaterThan1500k>0.64940</wirelineDownloadSpeedGreaterThan1500k>
      <wirelineDownloadSpeedGreaterThan3000k>0.58750</wirelineDownloadSpeedGreaterThan3000k>
      <wirelineDownloadSpeedGreaterThan6000k>0.55670</wirelineDownloadSpeedGreaterThan6000k>
      <wirelineDownloadSpeedGreaterThan10000k>0.51370</wirelineDownloadSpeedGreaterThan10000k>
      <wirelineDownloadSpeedGreaterThan25000k>0.02340</wirelineDownloadSpeedGreaterThan25000k>
      <wirelineDownloadSpeedGreaterThan50000k>0.00000</wirelineDownloadSpeedGreaterThan50000k>
      <wirelineDownloadSpeedGreaterThan100000k>0.00000</wirelineDownloadSpeedGreaterThan100000k>
      <wirelineDownloadSpeedGreaterThan1Gig>0.00000</wirelineDownloadSpeedGreaterThan1Gig>
      <wirelineUploadSpeedLessThan200k>0.00000</wirelineUploadSpeedLessThan200k>
      <wirelineUploadSpeedGreaterThan200k>0.66350</wirelineUploadSpeedGreaterThan200k>
      <wirelineUploadSpeedGreaterThan768k>0.55670</wirelineUploadSpeedGreaterThan768k>
      <wirelineUploadSpeedGreaterThan1500k>0.47000</wirelineUploadSpeedGreaterThan1500k>
      <wirelineUploadSpeedGreaterThan3000k>0.03220</wirelineUploadSpeedGreaterThan3000k>
      <wirelineUploadSpeedGreaterThan6000k>0.02340</wirelineUploadSpeedGreaterThan6000k>
      <wirelineUploadSpeedGreaterThan10000k>0.00000</wirelineUploadSpeedGreaterThan10000k>
      <wirelineUploadSpeedGreaterThan25000k>0.00000</wirelineUploadSpeedGreaterThan25000k>
      <wirelineUploadSpeedGreaterThan50000k>0.00000</wirelineUploadSpeedGreaterThan50000k>
      <wirelineUploadSpeedGreaterThan100000k>0.00000</wirelineUploadSpeedGreaterThan100000k>
      <wirelineUploadSpeedGreaterThan1Gig>0.00000</wirelineUploadSpeedGreaterThan1Gig>
      <wirelineDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k>0.66350</wirelineDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k>
      <wirelineDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k>0.55670</wirelineDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k>
      <wirelessDownloadSpeedGreaterThan768k>0.99010</wirelessDownloadSpeedGreaterThan768k>
      <wirelessDownloadSpeedGreaterThan1500k>0.99010</wirelessDownloadSpeedGreaterThan1500k>
      <wirelessDownloadSpeedGreaterThan3000k>0.99000</wirelessDownloadSpeedGreaterThan3000k>
      <wirelessDownloadSpeedGreaterThan6000k>0.94640</wirelessDownloadSpeedGreaterThan6000k>
      <wirelessDownloadSpeedGreaterThan10000k>0.94640</wirelessDownloadSpeedGreaterThan10000k>
      <wirelessDownloadSpeedGreaterThan25000k>0.00000</wirelessDownloadSpeedGreaterThan25000k>
      <wirelessDownloadSpeedGreaterThan50000k>0.00000</wirelessDownloadSpeedGreaterThan50000k>
      <wirelessDownloadSpeedGreaterThan100000k>0.00000</wirelessDownloadSpeedGreaterThan100000k>
      <wirelessDownloadSpeedGreaterThan1Gig>0.00000</wirelessDownloadSpeedGreaterThan1Gig>
      <wirelessUploadSpeedLessThan200k>0.00000</wirelessUploadSpeedLessThan200k>
      <wirelessUploadSpeedGreaterThan200k>0.99010</wirelessUploadSpeedGreaterThan200k>
      <wirelessUploadSpeedGreaterThan768k>0.99010</wirelessUploadSpeedGreaterThan768k>
      <wirelessUploadSpeedGreaterThan1500k>0.99000</wirelessUploadSpeedGreaterThan1500k>
      <wirelessUploadSpeedGreaterThan3000k>0.94640</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.99010</wirelessDownloadSpeedGreaterThan768kAndUploadSpeedGreaterThan200k>
      <wirelessDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k>0.99000</wirelessDownloadSpeedGreaterThan3000kAndUploadSpeedGreaterThan768k>
      <anyTechnology>0.99260</anyTechnology>
      <anyWireline>0.66350</anyWireline>
      <dsl>0.66080</dsl>
      <asymmetricDsl>0.66080</asymmetricDsl>
      <symmetricDsl>0.00000</symmetricDsl>
      <copper>0.00000</copper>
      <cable>0.00000</cable>
      <cableDocsis>0.00000</cableDocsis>
      <cableOther>0.00000</cableOther>
      <opticalFiber>0.00270</opticalFiber>
      <powerline>0.00000</powerline>
      <anyWireless>0.99010</anyWireless>
      <satellite>0.00000</satellite>
      <fixedWireless>0.00000</fixedWireless>
      <fixedWirelessUnlicensed>0.00000</fixedWirelessUnlicensed>
      <fixedWirelessLicensed>0.00000</fixedWirelessLicensed>
      <mobileWireless>0.99010</mobileWireless>
      <otherTechnology>0.00000</otherTechnology>
      <mostCommonDownloadSpeed>3.00000</mostCommonDownloadSpeed>
      <mostCommonDownloadSpeedPercentage>0.99260</mostCommonDownloadSpeedPercentage>
      <greatestDownloadSpeed>8.00000</greatestDownloadSpeed>
      <greatestDownloadSpeedPercentage>0.02340</greatestDownloadSpeedPercentage>
      <mostCommonUploadSpeed>2.00000</mostCommonUploadSpeed>
      <mostCommonUploadSpeedPercentage>0.99260</mostCommonUploadSpeedPercentage>
      <greatestUploadSpeed>6.00000</greatestUploadSpeed>
      <greatestUploadSpeedPercentage>0.02340</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>




Back to Top

You are automatically leaving the National Broadband Map site press escape key to cancel

You're leaving the National Broadband Map Website

You are now leaving the National Broadband Map web site, and will be automatically forwarded to the following site:

%url%

This link is provided for informational purposes only. We do not endorse any other product or service, and are not responsible for the content of other websites, including their accuracy, completeness, or timeliness.