Developer

API » Provider Statistics API - All Providers Within A Geography

Description
This API returns all the providers available in the specified geography.

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 all the providers within the geography.

Review Data Dictionary

JSON XML

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

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

Sample Call
http://www.broadbandmap.gov/broadbandmap/provider/jun2012/providers/state/01/population/congdistrict/0111101?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.

{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.

Optional Parameters
format:
XML, JSON, JSONP (XML is default)

callback:
JSONP callback function name

Response

JSON XML

{
 "status":"OK",
 "responseTime":4,
 "message":[
  
 ],
 "Results":{
  "allProviders":[
   {
    "holdingCompanyNumber":"130077",
    "holdingCompanyName":"AT&T Inc."
   },
   {
    "holdingCompanyNumber":"130159",
    "holdingCompanyName":"Bright House Networks, LLC"
   },
   {
    "holdingCompanyNumber":"130210",
    "holdingCompanyName":"Castleberry Communications"
   },
   {
    "holdingCompanyNumber":"130228",
    "holdingCompanyName":"CenturyLink, Inc."
   },
   {
    "holdingCompanyNumber":"130258",
    "holdingCompanyName":"Frontier Communications Corporation"
   },
   {
    "holdingCompanyNumber":"130317",
    "holdingCompanyName":"Comcast Corporation"
   },
   {
    "holdingCompanyNumber":"130403",
    "holdingCompanyName":"T-Mobile"
   },
   {
    "holdingCompanyNumber":"130738",
    "holdingCompanyName":"Level 3 Communications, LLC"
   },
   {
    "holdingCompanyNumber":"130804",
    "holdingCompanyName":"Mediacom Communications Corp."
   },
   {
    "holdingCompanyNumber":"130844",
    "holdingCompanyName":"Millry Corporation"
   },
   {
    "holdingCompanyNumber":"131038",
    "holdingCompanyName":"Pine Belt Communications Co. Inc."
   },
   {
    "holdingCompanyNumber":"131244",
    "holdingCompanyName":"Sprint Nextel Corporation"
   },
   {
    "holdingCompanyNumber":"131425",
    "holdingCompanyName":"Verizon Communications Inc."
   },
   {
    "holdingCompanyNumber":"160153",
    "holdingCompanyName":"tw telecom inc."
   },
   {
    "holdingCompanyNumber":"170085",
    "holdingCompanyName":"Southern Light, LLC"
   },
   {
    "holdingCompanyNumber":"900313",
    "holdingCompanyName":"Butler Telephone Company, Inc."
   }
  ]
 }
}

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Response status="OK" responseTime="3">
  <Results>
    <allProviders>
      <holdingCompanyNumber>130077</holdingCompanyNumber>
      <holdingCompanyName>AT&amp;T Inc.</holdingCompanyName>
   </allProviders>
   <allProviders>
     <holdingCompanyNumber>130159</holdingCompanyNumber>
     <holdingCompanyName>Bright House Networks, LLC</holdingCompanyName>
  </allProviders>
  <allProviders>
    <holdingCompanyNumber>130210</holdingCompanyNumber>
    <holdingCompanyName>Castleberry Communications</holdingCompanyName>
 </allProviders>
 <allProviders>
   <holdingCompanyNumber>130228</holdingCompanyNumber>
   <holdingCompanyName>CenturyLink, Inc.</holdingCompanyName>
</allProviders>
<allProviders>
  <holdingCompanyNumber>130258</holdingCompanyNumber>
  <holdingCompanyName>Frontier Communications Corporation</holdingCompanyName>
</allProviders>
<allProviders>
 <holdingCompanyNumber>130317</holdingCompanyNumber>
 <holdingCompanyName>Comcast Corporation</holdingCompanyName>
</allProviders>
<allProviders>
<holdingCompanyNumber>130403</holdingCompanyNumber>
<holdingCompanyName>T-Mobile</holdingCompanyName>
</allProviders>
<allProviders>
<holdingCompanyNumber>130738</holdingCompanyNumber>
<holdingCompanyName>Level 3 Communications, LLC</holdingCompanyName>
</allProviders>
<allProviders>
<holdingCompanyNumber>130804</holdingCompanyNumber>
<holdingCompanyName>Mediacom Communications Corp.</holdingCompanyName>
</allProviders>
<allProviders>
<holdingCompanyNumber>130844</holdingCompanyNumber>
<holdingCompanyName>Millry Corporation</holdingCompanyName>
</allProviders>
<allProviders>
<holdingCompanyNumber>131038</holdingCompanyNumber>
<holdingCompanyName>Pine Belt Communications Co. Inc.</holdingCompanyName>
</allProviders>
<allProviders>
<holdingCompanyNumber>131244</holdingCompanyNumber>
<holdingCompanyName>Sprint Nextel Corporation</holdingCompanyName>
</allProviders>
<allProviders>
<holdingCompanyNumber>131425</holdingCompanyNumber>
<holdingCompanyName>Verizon Communications Inc.</holdingCompanyName>
</allProviders>
<allProviders>
<holdingCompanyNumber>160153</holdingCompanyNumber>
<holdingCompanyName>tw telecom inc.</holdingCompanyName>
</allProviders>
<allProviders>
<holdingCompanyNumber>170085</holdingCompanyNumber>
<holdingCompanyName>Southern Light, LLC</holdingCompanyName>
</allProviders>
<allProviders>
<holdingCompanyNumber>900313</holdingCompanyNumber>
<holdingCompanyName>Butler Telephone Company, Inc.</holdingCompanyName>
</allProviders>
</Results>
</Response>

Developer

API » Provider Statistics API - All Providers Within A Geography

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

You're leaving the National Broadband Map Website