Developer

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


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

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 state and ID? The more people know about their broadband access speed the better.

Review Data Dictionary

JSON   XML

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

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

Sample Call
https://www.broadbandmap.gov/broadbandmap/speedtest/state/ids/01,02?format=json

Required Parameters
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
speedTestType:
specify the speed test type among any,ookla,mlab with default being any

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

callback (optional)
JSONP callback function name

Response

JSON   XML

{
 "status":"OK",
 "responseTime":9,
 "message":[
  
 ],
 "Results":[
  {
   "geographyId":"01",
   "geographyName":"Alabama",
   "accessingFrom":"Business",
   "numberOfTests":277,
   "medianDownload":6.47363,
   "lowerQuartileDownload":2.10286,
   "upperQuartileDownload":12.80273,
   "medianUpload":2.85700,
   "lowerQuartileUpload":1.23900,
   "upperQuartileUpload":6.01465
  },
  {
   "geographyId":"01",
   "geographyName":"Alabama",
   "accessingFrom":"CC_library_school",
   "numberOfTests":114,
   "medianDownload":12.52469,
   "lowerQuartileDownload":4.30230,
   "upperQuartileDownload":30.46875,
   "medianUpload":8.95069,
   "lowerQuartileUpload":2.45400,
   "upperQuartileUpload":14.41699
  },
  {
   "geographyId":"01",
   "geographyName":"Alabama",
   "accessingFrom":"Home",
   "numberOfTests":8251,
   "medianDownload":5.66401,
   "lowerQuartileDownload":2.32617,
   "upperQuartileDownload":12.88504,
   "medianUpload":1.00098,
   "lowerQuartileUpload":0.38800,
   "upperQuartileUpload":1.95996
  },
  {
   "geographyId":"01",
   "geographyName":"Alabama",
   "accessingFrom":"Mobile",
   "numberOfTests":33075,
   "medianDownload":2.04492,
   "lowerQuartileDownload":0.74707,
   "upperQuartileDownload":5.91797,
   "medianUpload":0.77148,
   "lowerQuartileUpload":0.32031,
   "upperQuartileUpload":2.02637
  },
  {
   "geographyId":"01",
   "geographyName":"Alabama",
   "accessingFrom":"Other",
   "numberOfTests":65,
   "medianDownload":6.41313,
   "lowerQuartileDownload":1.41113,
   "upperQuartileDownload":18.23730,
   "medianUpload":1.50879,
   "lowerQuartileUpload":0.44238,
   "upperQuartileUpload":4.71875
  },
  {
   "geographyId":"01",
   "geographyName":"Alabama",
   "accessingFrom":"Small_Business",
   "numberOfTests":362,
   "medianDownload":3.06189,
   "lowerQuartileDownload":1.39063,
   "upperQuartileDownload":7.53320,
   "medianUpload":0.96500,
   "lowerQuartileUpload":0.41211,
   "upperQuartileUpload":2.39258
  },
  {
   "geographyId":"02",
   "geographyName":"Alaska",
   "accessingFrom":"Business",
   "numberOfTests":125,
   "medianDownload":6.75977,
   "lowerQuartileDownload":3.06445,
   "upperQuartileDownload":23.26855,
   "medianUpload":5.54395,
   "lowerQuartileUpload":2.22800,
   "upperQuartileUpload":11.68359
  },
  {
   "geographyId":"02",
   "geographyName":"Alaska",
   "accessingFrom":"CC_library_school",
   "numberOfTests":35,
   "medianDownload":7.88256,
   "lowerQuartileDownload":3.89478,
   "upperQuartileDownload":16.63965,
   "medianUpload":6.23242,
   "lowerQuartileUpload":2.39100,
   "upperQuartileUpload":8.31200
  },
  {
   "geographyId":"02",
   "geographyName":"Alaska",
   "accessingFrom":"Home",
   "numberOfTests":1485,
   "medianDownload":2.59594,
   "lowerQuartileDownload":0.97168,
   "upperQuartileDownload":4.98828,
   "medianUpload":0.46680,
   "lowerQuartileUpload":0.25879,
   "upperQuartileUpload":0.66797
  },
  {
   "geographyId":"02",
   "geographyName":"Alaska",
   "accessingFrom":"Mobile",
   "numberOfTests":6891,
   "medianDownload":1.36621,
   "lowerQuartileDownload":0.46680,
   "upperQuartileDownload":3.43457,
   "medianUpload":0.47070,
   "lowerQuartileUpload":0.23926,
   "upperQuartileUpload":0.94824
  },
  {
   "geographyId":"02",
   "geographyName":"Alaska",
   "accessingFrom":"Other",
   "numberOfTests":35,
   "medianDownload":3.69727,
   "lowerQuartileDownload":0.32031,
   "upperQuartileDownload":12.02344,
   "medianUpload":1.56800,
   "lowerQuartileUpload":0.24414,
   "upperQuartileUpload":6.25391
  },
  {
   "geographyId":"02",
   "geographyName":"Alaska",
   "accessingFrom":"Small_Business",
   "numberOfTests":108,
   "medianDownload":1.51898,
   "lowerQuartileDownload":0.95876,
   "upperQuartileDownload":3.29395,
   "medianUpload":0.67150,
   "lowerQuartileUpload":0.30566,
   "upperQuartileUpload":1.23438
  }
 ]
}
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Response status="OK" responseTime="9">
  <Results>
    <numberOfTests>277</numberOfTests>
    <medianDownload>6.47363</medianDownload>
    <lowerQuartileDownload>2.10286</lowerQuartileDownload>
    <upperQuartileDownload>12.80273</upperQuartileDownload>
    <medianUpload>2.85700</medianUpload>
    <lowerQuartileUpload>1.23900</lowerQuartileUpload>
    <upperQuartileUpload>6.01465</upperQuartileUpload>
    <geographyId>01</geographyId>
    <geographyName>Alabama</geographyName>
    <accessingFrom>Business</accessingFrom>
 </Results>
 <Results>
   <numberOfTests>114</numberOfTests>
   <medianDownload>12.52469</medianDownload>
   <lowerQuartileDownload>4.30230</lowerQuartileDownload>
   <upperQuartileDownload>30.46875</upperQuartileDownload>
   <medianUpload>8.95069</medianUpload>
   <lowerQuartileUpload>2.45400</lowerQuartileUpload>
   <upperQuartileUpload>14.41699</upperQuartileUpload>
   <geographyId>01</geographyId>
   <geographyName>Alabama</geographyName>
   <accessingFrom>CC_library_school</accessingFrom>
</Results>
<Results>
  <numberOfTests>8251</numberOfTests>
  <medianDownload>5.66401</medianDownload>
  <lowerQuartileDownload>2.32617</lowerQuartileDownload>
  <upperQuartileDownload>12.88504</upperQuartileDownload>
  <medianUpload>1.00098</medianUpload>
  <lowerQuartileUpload>0.38800</lowerQuartileUpload>
  <upperQuartileUpload>1.95996</upperQuartileUpload>
  <geographyId>01</geographyId>
  <geographyName>Alabama</geographyName>
  <accessingFrom>Home</accessingFrom>
</Results>
<Results>
 <numberOfTests>33075</numberOfTests>
 <medianDownload>2.04492</medianDownload>
 <lowerQuartileDownload>0.74707</lowerQuartileDownload>
 <upperQuartileDownload>5.91797</upperQuartileDownload>
 <medianUpload>0.77148</medianUpload>
 <lowerQuartileUpload>0.32031</lowerQuartileUpload>
 <upperQuartileUpload>2.02637</upperQuartileUpload>
 <geographyId>01</geographyId>
 <geographyName>Alabama</geographyName>
 <accessingFrom>Mobile</accessingFrom>
</Results>
<Results>
<numberOfTests>65</numberOfTests>
<medianDownload>6.41313</medianDownload>
<lowerQuartileDownload>1.41113</lowerQuartileDownload>
<upperQuartileDownload>18.23730</upperQuartileDownload>
<medianUpload>1.50879</medianUpload>
<lowerQuartileUpload>0.44238</lowerQuartileUpload>
<upperQuartileUpload>4.71875</upperQuartileUpload>
<geographyId>01</geographyId>
<geographyName>Alabama</geographyName>
<accessingFrom>Other</accessingFrom>
</Results>
<Results>
<numberOfTests>362</numberOfTests>
<medianDownload>3.06189</medianDownload>
<lowerQuartileDownload>1.39063</lowerQuartileDownload>
<upperQuartileDownload>7.53320</upperQuartileDownload>
<medianUpload>0.96500</medianUpload>
<lowerQuartileUpload>0.41211</lowerQuartileUpload>
<upperQuartileUpload>2.39258</upperQuartileUpload>
<geographyId>01</geographyId>
<geographyName>Alabama</geographyName>
<accessingFrom>Small_Business</accessingFrom>
</Results>
<Results>
<numberOfTests>125</numberOfTests>
<medianDownload>6.75977</medianDownload>
<lowerQuartileDownload>3.06445</lowerQuartileDownload>
<upperQuartileDownload>23.26855</upperQuartileDownload>
<medianUpload>5.54395</medianUpload>
<lowerQuartileUpload>2.22800</lowerQuartileUpload>
<upperQuartileUpload>11.68359</upperQuartileUpload>
<geographyId>02</geographyId>
<geographyName>Alaska</geographyName>
<accessingFrom>Business</accessingFrom>
</Results>
<Results>
<numberOfTests>35</numberOfTests>
<medianDownload>7.88256</medianDownload>
<lowerQuartileDownload>3.89478</lowerQuartileDownload>
<upperQuartileDownload>16.63965</upperQuartileDownload>
<medianUpload>6.23242</medianUpload>
<lowerQuartileUpload>2.39100</lowerQuartileUpload>
<upperQuartileUpload>8.31200</upperQuartileUpload>
<geographyId>02</geographyId>
<geographyName>Alaska</geographyName>
<accessingFrom>CC_library_school</accessingFrom>
</Results>
<Results>
<numberOfTests>1485</numberOfTests>
<medianDownload>2.59594</medianDownload>
<lowerQuartileDownload>0.97168</lowerQuartileDownload>
<upperQuartileDownload>4.98828</upperQuartileDownload>
<medianUpload>0.46680</medianUpload>
<lowerQuartileUpload>0.25879</lowerQuartileUpload>
<upperQuartileUpload>0.66797</upperQuartileUpload>
<geographyId>02</geographyId>
<geographyName>Alaska</geographyName>
<accessingFrom>Home</accessingFrom>
</Results>
<Results>
<numberOfTests>6891</numberOfTests>
<medianDownload>1.36621</medianDownload>
<lowerQuartileDownload>0.46680</lowerQuartileDownload>
<upperQuartileDownload>3.43457</upperQuartileDownload>
<medianUpload>0.47070</medianUpload>
<lowerQuartileUpload>0.23926</lowerQuartileUpload>
<upperQuartileUpload>0.94824</upperQuartileUpload>
<geographyId>02</geographyId>
<geographyName>Alaska</geographyName>
<accessingFrom>Mobile</accessingFrom>
</Results>
<Results>
<numberOfTests>35</numberOfTests>
<medianDownload>3.69727</medianDownload>
<lowerQuartileDownload>0.32031</lowerQuartileDownload>
<upperQuartileDownload>12.02344</upperQuartileDownload>
<medianUpload>1.56800</medianUpload>
<lowerQuartileUpload>0.24414</lowerQuartileUpload>
<upperQuartileUpload>6.25391</upperQuartileUpload>
<geographyId>02</geographyId>
<geographyName>Alaska</geographyName>
<accessingFrom>Other</accessingFrom>
</Results>
<Results>
<numberOfTests>108</numberOfTests>
<medianDownload>1.51898</medianDownload>
<lowerQuartileDownload>0.95876</lowerQuartileDownload>
<upperQuartileDownload>3.29395</upperQuartileDownload>
<medianUpload>0.67150</medianUpload>
<lowerQuartileUpload>0.30566</lowerQuartileUpload>
<upperQuartileUpload>1.23438</upperQuartileUpload>
<geographyId>02</geographyId>
<geographyName>Alaska</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.