Developer

API » Speed Test API - By Geography Type And Geography Name


Description
This API returns the speed test results for a particular geography type (e.g., state, congressional district) and geography name (e.g., Virginia).

Why We Provide It
We are providing this API to increase the value of the consumer broadband test. Currently the consumer broadband test only gives the result of the individual test. We think individuals would like to know the context of their test; do I get a similar result to the average tests in my congressional district and city? The more people know about their broadband access speed the better.

Review Data Dictionary

JSON   XML

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

API Call
{API Base}/speedtest/{geographyType}/names/{geographyNames}?testtype={speedTestType}&format={format}&callback={functionName}//

Sample Call
http://www.broadbandmap.gov/broadbandmap/speedtest/state/names/alabama,arizona?format=json

Required Parameters
geographyType:
specify one of the following geography type: censusplace, msa, usf, county, statesenate, statehouse, congdistrict

geographyNames:
specify the geography IDs to search for separated by commas and a maximum of 10 are allowed

Optional Parameters
speedTestType:
specify the geography names to search for separated by commas and a maximum of 10 are allowed

format (optional):
XML, JSON, JSONP (XML is default)

callback (optional)
JSONP callback function name

Response

JSON   XML 

{
 "status":"OK",
 "responseTime":19,
 "message":[
  
 ],
 "Results":[
  {
   "geographyId":"01",
   "geographyName":"Alabama",
   "accessingFrom":"Business",
   "numberOfTests":270,
   "medianDownload":6.52051,
   "lowerQuartileDownload":2.18262,
   "upperQuartileDownload":12.98340,
   "medianUpload":2.89000,
   "lowerQuartileUpload":1.27148,
   "upperQuartileUpload":6.25600
  },
  {
   "geographyId":"01",
   "geographyName":"Alabama",
   "accessingFrom":"Business",
   "numberOfTests":270,
   "medianDownload":6.52051,
   "lowerQuartileDownload":2.18262,
   "upperQuartileDownload":12.98340,
   "medianUpload":2.89000,
   "lowerQuartileUpload":1.27148,
   "upperQuartileUpload":6.25600
  },
  {
   "geographyId":"01",
   "geographyName":"Alabama",
   "accessingFrom":"CC_library_school",
   "numberOfTests":104,
   "medianDownload":13.14107,
   "lowerQuartileDownload":3.97852,
   "upperQuartileDownload":31.95703,
   "medianUpload":8.79590,
   "lowerQuartileUpload":2.43262,
   "upperQuartileUpload":13.75098
  },
  {
   "geographyId":"01",
   "geographyName":"Alabama",
   "accessingFrom":"CC_library_school",
   "numberOfTests":104,
   "medianDownload":13.14107,
   "lowerQuartileDownload":3.97852,
   "upperQuartileDownload":31.95703,
   "medianUpload":8.79590,
   "lowerQuartileUpload":2.43262,
   "upperQuartileUpload":13.75098
  },
  {
   "geographyId":"01",
   "geographyName":"Alabama",
   "accessingFrom":"Home",
   "numberOfTests":7261,
   "medianDownload":5.62402,
   "lowerQuartileDownload":2.35840,
   "upperQuartileDownload":12.46875,
   "medianUpload":0.96700,
   "lowerQuartileUpload":0.39100,
   "upperQuartileUpload":1.85449
  },
  {
   "geographyId":"01",
   "geographyName":"Alabama",
   "accessingFrom":"Home",
   "numberOfTests":7261,
   "medianDownload":5.62402,
   "lowerQuartileDownload":2.35840,
   "upperQuartileDownload":12.46875,
   "medianUpload":0.96700,
   "lowerQuartileUpload":0.39100,
   "upperQuartileUpload":1.85449
  },
  {
   "geographyId":"01",
   "geographyName":"Alabama",
   "accessingFrom":"Mobile",
   "numberOfTests":26064,
   "medianDownload":1.72754,
   "lowerQuartileDownload":0.69336,
   "upperQuartileDownload":5.00391,
   "medianUpload":0.65625,
   "lowerQuartileUpload":0.29395,
   "upperQuartileUpload":1.45020
  },
  {
   "geographyId":"01",
   "geographyName":"Alabama",
   "accessingFrom":"Mobile",
   "numberOfTests":26064,
   "medianDownload":1.72754,
   "lowerQuartileDownload":0.69336,
   "upperQuartileDownload":5.00391,
   "medianUpload":0.65625,
   "lowerQuartileUpload":0.29395,
   "upperQuartileUpload":1.45020
  },
  {
   "geographyId":"01",
   "geographyName":"Alabama",
   "accessingFrom":"Other",
   "numberOfTests":63,
   "medianDownload":6.41313,
   "lowerQuartileDownload":1.33894,
   "upperQuartileDownload":19.42469,
   "medianUpload":1.44434,
   "lowerQuartileUpload":0.42285,
   "upperQuartileUpload":4.43945
  },
  {
   "geographyId":"01",
   "geographyName":"Alabama",
   "accessingFrom":"Other",
   "numberOfTests":63,
   "medianDownload":6.41313,
   "lowerQuartileDownload":1.33894,
   "upperQuartileDownload":19.42469,
   "medianUpload":1.44434,
   "lowerQuartileUpload":0.42285,
   "upperQuartileUpload":4.43945
  },
  {
   "geographyId":"01",
   "geographyName":"Alabama",
   "accessingFrom":"Small_Business",
   "numberOfTests":319,
   "medianDownload":3.00098,
   "lowerQuartileDownload":1.38574,
   "upperQuartileDownload":6.98872,
   "medianUpload":0.98300,
   "lowerQuartileUpload":0.41211,
   "upperQuartileUpload":2.27051
  },
  {
   "geographyId":"01",
   "geographyName":"Alabama",
   "accessingFrom":"Small_Business",
   "numberOfTests":319,
   "medianDownload":3.00098,
   "lowerQuartileDownload":1.38574,
   "upperQuartileDownload":6.98872,
   "medianUpload":0.98300,
   "lowerQuartileUpload":0.41211,
   "upperQuartileUpload":2.27051
  },
  {
   "geographyId":"04",
   "geographyName":"Arizona",
   "accessingFrom":"Business",
   "numberOfTests":454,
   "medianDownload":8.29041,
   "lowerQuartileDownload":2.80664,
   "upperQuartileDownload":21.28223,
   "medianUpload":5.68944,
   "lowerQuartileUpload":1.73047,
   "upperQuartileUpload":10.72461
  },
  {
   "geographyId":"04",
   "geographyName":"Arizona",
   "accessingFrom":"Business",
   "numberOfTests":454,
   "medianDownload":8.29041,
   "lowerQuartileDownload":2.80664,
   "upperQuartileDownload":21.28223,
   "medianUpload":5.68944,
   "lowerQuartileUpload":1.73047,
   "upperQuartileUpload":10.72461
  },
  {
   "geographyId":"04",
   "geographyName":"Arizona",
   "accessingFrom":"CC_library_school",
   "numberOfTests":202,
   "medianDownload":9.96680,
   "lowerQuartileDownload":4.13870,
   "upperQuartileDownload":31.28516,
   "medianUpload":5.77002,
   "lowerQuartileUpload":1.74609,
   "upperQuartileUpload":11.39200
  },
  {
   "geographyId":"04",
   "geographyName":"Arizona",
   "accessingFrom":"CC_library_school",
   "numberOfTests":202,
   "medianDownload":9.96680,
   "lowerQuartileDownload":4.13870,
   "upperQuartileDownload":31.28516,
   "medianUpload":5.77002,
   "lowerQuartileUpload":1.74609,
   "upperQuartileUpload":11.39200
  },
  {
   "geographyId":"04",
   "geographyName":"Arizona",
   "accessingFrom":"Home",
   "numberOfTests":23040,
   "medianDownload":6.92383,
   "lowerQuartileDownload":2.88792,
   "upperQuartileDownload":15.78613,
   "medianUpload":1.83800,
   "lowerQuartileUpload":0.70703,
   "upperQuartileUpload":4.19700
  },
  {
   "geographyId":"04",
   "geographyName":"Arizona",
   "accessingFrom":"Home",
   "numberOfTests":23040,
   "medianDownload":6.92383,
   "lowerQuartileDownload":2.88792,
   "upperQuartileDownload":15.78613,
   "medianUpload":1.83800,
   "lowerQuartileUpload":0.70703,
   "upperQuartileUpload":4.19700
  },
  {
   "geographyId":"04",
   "geographyName":"Arizona",
   "accessingFrom":"Mobile",
   "numberOfTests":50740,
   "medianDownload":1.82910,
   "lowerQuartileDownload":0.68066,
   "upperQuartileDownload":5.18457,
   "medianUpload":0.78125,
   "lowerQuartileUpload":0.35938,
   "upperQuartileUpload":2.27539
  },
  {
   "geographyId":"04",
   "geographyName":"Arizona",
   "accessingFrom":"Mobile",
   "numberOfTests":50740,
   "medianDownload":1.82910,
   "lowerQuartileDownload":0.68066,
   "upperQuartileDownload":5.18457,
   "medianUpload":0.78125,
   "lowerQuartileUpload":0.35938,
   "upperQuartileUpload":2.27539
  },
  {
   "geographyId":"04",
   "geographyName":"Arizona",
   "accessingFrom":"Other",
   "numberOfTests":184,
   "medianDownload":6.51514,
   "lowerQuartileDownload":1.33887,
   "upperQuartileDownload":16.73315,
   "medianUpload":2.24952,
   "lowerQuartileUpload":0.66602,
   "upperQuartileUpload":5.45020
  },
  {
   "geographyId":"04",
   "geographyName":"Arizona",
   "accessingFrom":"Other",
   "numberOfTests":184,
   "medianDownload":6.51514,
   "lowerQuartileDownload":1.33887,
   "upperQuartileDownload":16.73315,
   "medianUpload":2.24952,
   "lowerQuartileUpload":0.66602,
   "upperQuartileUpload":5.45020
  },
  {
   "geographyId":"04",
   "geographyName":"Arizona",
   "accessingFrom":"Small_Business",
   "numberOfTests":785,
   "medianDownload":3.94265,
   "lowerQuartileDownload":1.51563,
   "upperQuartileDownload":11.21094,
   "medianUpload":1.39258,
   "lowerQuartileUpload":0.63672,
   "upperQuartileUpload":4.01563
  },
  {
   "geographyId":"04",
   "geographyName":"Arizona",
   "accessingFrom":"Small_Business",
   "numberOfTests":785,
   "medianDownload":3.94265,
   "lowerQuartileDownload":1.51563,
   "upperQuartileDownload":11.21094,
   "medianUpload":1.39258,
   "lowerQuartileUpload":0.63672,
   "upperQuartileUpload":4.01563
  }
 ]
}

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Response status="OK" responseTime="12">
  <Results>
    <numberOfTests>270</numberOfTests>
    <medianDownload>6.52051</medianDownload>
    <lowerQuartileDownload>2.18262</lowerQuartileDownload>
    <upperQuartileDownload>12.98340</upperQuartileDownload>
    <medianUpload>2.89000</medianUpload>
    <lowerQuartileUpload>1.27148</lowerQuartileUpload>
    <upperQuartileUpload>6.25600</upperQuartileUpload>
    <geographyId>01</geographyId>
    <geographyName>Alabama</geographyName>
    <accessingFrom>Business</accessingFrom>
 </Results>
 <Results>
   <numberOfTests>270</numberOfTests>
   <medianDownload>6.52051</medianDownload>
   <lowerQuartileDownload>2.18262</lowerQuartileDownload>
   <upperQuartileDownload>12.98340</upperQuartileDownload>
   <medianUpload>2.89000</medianUpload>
   <lowerQuartileUpload>1.27148</lowerQuartileUpload>
   <upperQuartileUpload>6.25600</upperQuartileUpload>
   <geographyId>01</geographyId>
   <geographyName>Alabama</geographyName>
   <accessingFrom>Business</accessingFrom>
</Results>
<Results>
  <numberOfTests>104</numberOfTests>
  <medianDownload>13.14107</medianDownload>
  <lowerQuartileDownload>3.97852</lowerQuartileDownload>
  <upperQuartileDownload>31.95703</upperQuartileDownload>
  <medianUpload>8.79590</medianUpload>
  <lowerQuartileUpload>2.43262</lowerQuartileUpload>
  <upperQuartileUpload>13.75098</upperQuartileUpload>
  <geographyId>01</geographyId>
  <geographyName>Alabama</geographyName>
  <accessingFrom>CC_library_school</accessingFrom>
</Results>
<Results>
 <numberOfTests>104</numberOfTests>
 <medianDownload>13.14107</medianDownload>
 <lowerQuartileDownload>3.97852</lowerQuartileDownload>
 <upperQuartileDownload>31.95703</upperQuartileDownload>
 <medianUpload>8.79590</medianUpload>
 <lowerQuartileUpload>2.43262</lowerQuartileUpload>
 <upperQuartileUpload>13.75098</upperQuartileUpload>
 <geographyId>01</geographyId>
 <geographyName>Alabama</geographyName>
 <accessingFrom>CC_library_school</accessingFrom>
</Results>
<Results>
<numberOfTests>7261</numberOfTests>
<medianDownload>5.62402</medianDownload>
<lowerQuartileDownload>2.35840</lowerQuartileDownload>
<upperQuartileDownload>12.46875</upperQuartileDownload>
<medianUpload>0.96700</medianUpload>
<lowerQuartileUpload>0.39100</lowerQuartileUpload>
<upperQuartileUpload>1.85449</upperQuartileUpload>
<geographyId>01</geographyId>
<geographyName>Alabama</geographyName>
<accessingFrom>Home</accessingFrom>
</Results>
<Results>
<numberOfTests>7261</numberOfTests>
<medianDownload>5.62402</medianDownload>
<lowerQuartileDownload>2.35840</lowerQuartileDownload>
<upperQuartileDownload>12.46875</upperQuartileDownload>
<medianUpload>0.96700</medianUpload>
<lowerQuartileUpload>0.39100</lowerQuartileUpload>
<upperQuartileUpload>1.85449</upperQuartileUpload>
<geographyId>01</geographyId>
<geographyName>Alabama</geographyName>
<accessingFrom>Home</accessingFrom>
</Results>
<Results>
<numberOfTests>26064</numberOfTests>
<medianDownload>1.72754</medianDownload>
<lowerQuartileDownload>0.69336</lowerQuartileDownload>
<upperQuartileDownload>5.00391</upperQuartileDownload>
<medianUpload>0.65625</medianUpload>
<lowerQuartileUpload>0.29395</lowerQuartileUpload>
<upperQuartileUpload>1.45020</upperQuartileUpload>
<geographyId>01</geographyId>
<geographyName>Alabama</geographyName>
<accessingFrom>Mobile</accessingFrom>
</Results>
<Results>
<numberOfTests>26064</numberOfTests>
<medianDownload>1.72754</medianDownload>
<lowerQuartileDownload>0.69336</lowerQuartileDownload>
<upperQuartileDownload>5.00391</upperQuartileDownload>
<medianUpload>0.65625</medianUpload>
<lowerQuartileUpload>0.29395</lowerQuartileUpload>
<upperQuartileUpload>1.45020</upperQuartileUpload>
<geographyId>01</geographyId>
<geographyName>Alabama</geographyName>
<accessingFrom>Mobile</accessingFrom>
</Results>
<Results>
<numberOfTests>63</numberOfTests>
<medianDownload>6.41313</medianDownload>
<lowerQuartileDownload>1.33894</lowerQuartileDownload>
<upperQuartileDownload>19.42469</upperQuartileDownload>
<medianUpload>1.44434</medianUpload>
<lowerQuartileUpload>0.42285</lowerQuartileUpload>
<upperQuartileUpload>4.43945</upperQuartileUpload>
<geographyId>01</geographyId>
<geographyName>Alabama</geographyName>
<accessingFrom>Other</accessingFrom>
</Results>
<Results>
<numberOfTests>63</numberOfTests>
<medianDownload>6.41313</medianDownload>
<lowerQuartileDownload>1.33894</lowerQuartileDownload>
<upperQuartileDownload>19.42469</upperQuartileDownload>
<medianUpload>1.44434</medianUpload>
<lowerQuartileUpload>0.42285</lowerQuartileUpload>
<upperQuartileUpload>4.43945</upperQuartileUpload>
<geographyId>01</geographyId>
<geographyName>Alabama</geographyName>
<accessingFrom>Other</accessingFrom>
</Results>
<Results>
<numberOfTests>319</numberOfTests>
<medianDownload>3.00098</medianDownload>
<lowerQuartileDownload>1.38574</lowerQuartileDownload>
<upperQuartileDownload>6.98872</upperQuartileDownload>
<medianUpload>0.98300</medianUpload>
<lowerQuartileUpload>0.41211</lowerQuartileUpload>
<upperQuartileUpload>2.27051</upperQuartileUpload>
<geographyId>01</geographyId>
<geographyName>Alabama</geographyName>
<accessingFrom>Small_Business</accessingFrom>
</Results>
<Results>
<numberOfTests>319</numberOfTests>
<medianDownload>3.00098</medianDownload>
<lowerQuartileDownload>1.38574</lowerQuartileDownload>
<upperQuartileDownload>6.98872</upperQuartileDownload>
<medianUpload>0.98300</medianUpload>
<lowerQuartileUpload>0.41211</lowerQuartileUpload>
<upperQuartileUpload>2.27051</upperQuartileUpload>
<geographyId>01</geographyId>
<geographyName>Alabama</geographyName>
<accessingFrom>Small_Business</accessingFrom>
</Results>
<Results>
<numberOfTests>454</numberOfTests>
<medianDownload>8.29041</medianDownload>
<lowerQuartileDownload>2.80664</lowerQuartileDownload>
<upperQuartileDownload>21.28223</upperQuartileDownload>
<medianUpload>5.68944</medianUpload>
<lowerQuartileUpload>1.73047</lowerQuartileUpload>
<upperQuartileUpload>10.72461</upperQuartileUpload>
<geographyId>04</geographyId>
<geographyName>Arizona</geographyName>
<accessingFrom>Business</accessingFrom>
</Results>
<Results>
<numberOfTests>454</numberOfTests>
<medianDownload>8.29041</medianDownload>
<lowerQuartileDownload>2.80664</lowerQuartileDownload>
<upperQuartileDownload>21.28223</upperQuartileDownload>
<medianUpload>5.68944</medianUpload>
<lowerQuartileUpload>1.73047</lowerQuartileUpload>
<upperQuartileUpload>10.72461</upperQuartileUpload>
<geographyId>04</geographyId>
<geographyName>Arizona</geographyName>
<accessingFrom>Business</accessingFrom>
</Results>
<Results>
<numberOfTests>202</numberOfTests>
<medianDownload>9.96680</medianDownload>
<lowerQuartileDownload>4.13870</lowerQuartileDownload>
<upperQuartileDownload>31.28516</upperQuartileDownload>
<medianUpload>5.77002</medianUpload>
<lowerQuartileUpload>1.74609</lowerQuartileUpload>
<upperQuartileUpload>11.39200</upperQuartileUpload>
<geographyId>04</geographyId>
<geographyName>Arizona</geographyName>
<accessingFrom>CC_library_school</accessingFrom>
</Results>
<Results>
<numberOfTests>202</numberOfTests>
<medianDownload>9.96680</medianDownload>
<lowerQuartileDownload>4.13870</lowerQuartileDownload>
<upperQuartileDownload>31.28516</upperQuartileDownload>
<medianUpload>5.77002</medianUpload>
<lowerQuartileUpload>1.74609</lowerQuartileUpload>
<upperQuartileUpload>11.39200</upperQuartileUpload>
<geographyId>04</geographyId>
<geographyName>Arizona</geographyName>
<accessingFrom>CC_library_school</accessingFrom>
</Results>
<Results>
<numberOfTests>23040</numberOfTests>
<medianDownload>6.92383</medianDownload>
<lowerQuartileDownload>2.88792</lowerQuartileDownload>
<upperQuartileDownload>15.78613</upperQuartileDownload>
<medianUpload>1.83800</medianUpload>
<lowerQuartileUpload>0.70703</lowerQuartileUpload>
<upperQuartileUpload>4.19700</upperQuartileUpload>
<geographyId>04</geographyId>
<geographyName>Arizona</geographyName>
<accessingFrom>Home</accessingFrom>
</Results>
<Results>
<numberOfTests>23040</numberOfTests>
<medianDownload>6.92383</medianDownload>
<lowerQuartileDownload>2.88792</lowerQuartileDownload>
<upperQuartileDownload>15.78613</upperQuartileDownload>
<medianUpload>1.83800</medianUpload>
<lowerQuartileUpload>0.70703</lowerQuartileUpload>
<upperQuartileUpload>4.19700</upperQuartileUpload>
<geographyId>04</geographyId>
<geographyName>Arizona</geographyName>
<accessingFrom>Home</accessingFrom>
</Results>
<Results>
<numberOfTests>50740</numberOfTests>
<medianDownload>1.82910</medianDownload>
<lowerQuartileDownload>0.68066</lowerQuartileDownload>
<upperQuartileDownload>5.18457</upperQuartileDownload>
<medianUpload>0.78125</medianUpload>
<lowerQuartileUpload>0.35938</lowerQuartileUpload>
<upperQuartileUpload>2.27539</upperQuartileUpload>
<geographyId>04</geographyId>
<geographyName>Arizona</geographyName>
<accessingFrom>Mobile</accessingFrom>
</Results>
<Results>
<numberOfTests>50740</numberOfTests>
<medianDownload>1.82910</medianDownload>
<lowerQuartileDownload>0.68066</lowerQuartileDownload>
<upperQuartileDownload>5.18457</upperQuartileDownload>
<medianUpload>0.78125</medianUpload>
<lowerQuartileUpload>0.35938</lowerQuartileUpload>
<upperQuartileUpload>2.27539</upperQuartileUpload>
<geographyId>04</geographyId>
<geographyName>Arizona</geographyName>
<accessingFrom>Mobile</accessingFrom>
</Results>
<Results>
<numberOfTests>184</numberOfTests>
<medianDownload>6.51514</medianDownload>
<lowerQuartileDownload>1.33887</lowerQuartileDownload>
<upperQuartileDownload>16.73315</upperQuartileDownload>
<medianUpload>2.24952</medianUpload>
<lowerQuartileUpload>0.66602</lowerQuartileUpload>
<upperQuartileUpload>5.45020</upperQuartileUpload>
<geographyId>04</geographyId>
<geographyName>Arizona</geographyName>
<accessingFrom>Other</accessingFrom>
</Results>
<Results>
<numberOfTests>184</numberOfTests>
<medianDownload>6.51514</medianDownload>
<lowerQuartileDownload>1.33887</lowerQuartileDownload>
<upperQuartileDownload>16.73315</upperQuartileDownload>
<medianUpload>2.24952</medianUpload>
<lowerQuartileUpload>0.66602</lowerQuartileUpload>
<upperQuartileUpload>5.45020</upperQuartileUpload>
<geographyId>04</geographyId>
<geographyName>Arizona</geographyName>
<accessingFrom>Other</accessingFrom>
</Results>
<Results>
<numberOfTests>785</numberOfTests>
<medianDownload>3.94265</medianDownload>
<lowerQuartileDownload>1.51563</lowerQuartileDownload>
<upperQuartileDownload>11.21094</upperQuartileDownload>
<medianUpload>1.39258</medianUpload>
<lowerQuartileUpload>0.63672</lowerQuartileUpload>
<upperQuartileUpload>4.01563</upperQuartileUpload>
<geographyId>04</geographyId>
<geographyName>Arizona</geographyName>
<accessingFrom>Small_Business</accessingFrom>
</Results>
<Results>
<numberOfTests>785</numberOfTests>
<medianDownload>3.94265</medianDownload>
<lowerQuartileDownload>1.51563</lowerQuartileDownload>
<upperQuartileDownload>11.21094</upperQuartileDownload>
<medianUpload>1.39258</medianUpload>
<lowerQuartileUpload>0.63672</lowerQuartileUpload>
<upperQuartileUpload>4.01563</upperQuartileUpload>
<geographyId>04</geographyId>
<geographyName>Arizona</geographyName>
<accessingFrom>Small_Business</accessingFrom>
</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.