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
http://www.broadbandmap.gov/broadbandmap/

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

Sample Call
http://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":23,
 "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":"02",
   "geographyName":"Alaska",
   "accessingFrom":"Business",
   "numberOfTests":104,
   "medianDownload":6.15573,
   "lowerQuartileDownload":2.65723,
   "upperQuartileDownload":16.38281,
   "medianUpload":4.97901,
   "lowerQuartileUpload":1.55700,
   "upperQuartileUpload":9.11133
  },
  {
   "geographyId":"02",
   "geographyName":"Alaska",
   "accessingFrom":"Business",
   "numberOfTests":104,
   "medianDownload":6.15573,
   "lowerQuartileDownload":2.65723,
   "upperQuartileDownload":16.38281,
   "medianUpload":4.97901,
   "lowerQuartileUpload":1.55700,
   "upperQuartileUpload":9.11133
  },
  {
   "geographyId":"02",
   "geographyName":"Alaska",
   "accessingFrom":"CC_library_school",
   "numberOfTests":34,
   "medianDownload":7.81433,
   "lowerQuartileDownload":3.89478,
   "upperQuartileDownload":15.58496,
   "medianUpload":6.19483,
   "lowerQuartileUpload":2.39100,
   "upperQuartileUpload":8.27000
  },
  {
   "geographyId":"02",
   "geographyName":"Alaska",
   "accessingFrom":"CC_library_school",
   "numberOfTests":34,
   "medianDownload":7.81433,
   "lowerQuartileDownload":3.89478,
   "upperQuartileDownload":15.58496,
   "medianUpload":6.19483,
   "lowerQuartileUpload":2.39100,
   "upperQuartileUpload":8.27000
  },
  {
   "geographyId":"02",
   "geographyName":"Alaska",
   "accessingFrom":"Home",
   "numberOfTests":1401,
   "medianDownload":2.48529,
   "lowerQuartileDownload":0.93568,
   "upperQuartileDownload":4.52148,
   "medianUpload":0.46582,
   "lowerQuartileUpload":0.25488,
   "upperQuartileUpload":0.62695
  },
  {
   "geographyId":"02",
   "geographyName":"Alaska",
   "accessingFrom":"Home",
   "numberOfTests":1401,
   "medianDownload":2.48529,
   "lowerQuartileDownload":0.93568,
   "upperQuartileDownload":4.52148,
   "medianUpload":0.46582,
   "lowerQuartileUpload":0.25488,
   "upperQuartileUpload":0.62695
  },
  {
   "geographyId":"02",
   "geographyName":"Alaska",
   "accessingFrom":"Mobile",
   "numberOfTests":5204,
   "medianDownload":1.22315,
   "lowerQuartileDownload":0.45313,
   "upperQuartileDownload":2.87500,
   "medianUpload":0.44531,
   "lowerQuartileUpload":0.22656,
   "upperQuartileUpload":0.90430
  },
  {
   "geographyId":"02",
   "geographyName":"Alaska",
   "accessingFrom":"Mobile",
   "numberOfTests":5204,
   "medianDownload":1.22315,
   "lowerQuartileDownload":0.45313,
   "upperQuartileDownload":2.87500,
   "medianUpload":0.44531,
   "lowerQuartileUpload":0.22656,
   "upperQuartileUpload":0.90430
  },
  {
   "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":"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":99,
   "medianDownload":1.52819,
   "lowerQuartileDownload":0.96386,
   "upperQuartileDownload":3.29395,
   "medianUpload":0.70600,
   "lowerQuartileUpload":0.32813,
   "upperQuartileUpload":1.43400
  },
  {
   "geographyId":"02",
   "geographyName":"Alaska",
   "accessingFrom":"Small_Business",
   "numberOfTests":99,
   "medianDownload":1.52819,
   "lowerQuartileDownload":0.96386,
   "upperQuartileDownload":3.29395,
   "medianUpload":0.70600,
   "lowerQuartileUpload":0.32813,
   "upperQuartileUpload":1.43400
  }
 ]
}

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Response status="OK" responseTime="5">
  <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>104</numberOfTests>
<medianDownload>6.15573</medianDownload>
<lowerQuartileDownload>2.65723</lowerQuartileDownload>
<upperQuartileDownload>16.38281</upperQuartileDownload>
<medianUpload>4.97901</medianUpload>
<lowerQuartileUpload>1.55700</lowerQuartileUpload>
<upperQuartileUpload>9.11133</upperQuartileUpload>
<geographyId>02</geographyId>
<geographyName>Alaska</geographyName>
<accessingFrom>Business</accessingFrom>
</Results>
<Results>
<numberOfTests>104</numberOfTests>
<medianDownload>6.15573</medianDownload>
<lowerQuartileDownload>2.65723</lowerQuartileDownload>
<upperQuartileDownload>16.38281</upperQuartileDownload>
<medianUpload>4.97901</medianUpload>
<lowerQuartileUpload>1.55700</lowerQuartileUpload>
<upperQuartileUpload>9.11133</upperQuartileUpload>
<geographyId>02</geographyId>
<geographyName>Alaska</geographyName>
<accessingFrom>Business</accessingFrom>
</Results>
<Results>
<numberOfTests>34</numberOfTests>
<medianDownload>7.81433</medianDownload>
<lowerQuartileDownload>3.89478</lowerQuartileDownload>
<upperQuartileDownload>15.58496</upperQuartileDownload>
<medianUpload>6.19483</medianUpload>
<lowerQuartileUpload>2.39100</lowerQuartileUpload>
<upperQuartileUpload>8.27000</upperQuartileUpload>
<geographyId>02</geographyId>
<geographyName>Alaska</geographyName>
<accessingFrom>CC_library_school</accessingFrom>
</Results>
<Results>
<numberOfTests>34</numberOfTests>
<medianDownload>7.81433</medianDownload>
<lowerQuartileDownload>3.89478</lowerQuartileDownload>
<upperQuartileDownload>15.58496</upperQuartileDownload>
<medianUpload>6.19483</medianUpload>
<lowerQuartileUpload>2.39100</lowerQuartileUpload>
<upperQuartileUpload>8.27000</upperQuartileUpload>
<geographyId>02</geographyId>
<geographyName>Alaska</geographyName>
<accessingFrom>CC_library_school</accessingFrom>
</Results>
<Results>
<numberOfTests>1401</numberOfTests>
<medianDownload>2.48529</medianDownload>
<lowerQuartileDownload>0.93568</lowerQuartileDownload>
<upperQuartileDownload>4.52148</upperQuartileDownload>
<medianUpload>0.46582</medianUpload>
<lowerQuartileUpload>0.25488</lowerQuartileUpload>
<upperQuartileUpload>0.62695</upperQuartileUpload>
<geographyId>02</geographyId>
<geographyName>Alaska</geographyName>
<accessingFrom>Home</accessingFrom>
</Results>
<Results>
<numberOfTests>1401</numberOfTests>
<medianDownload>2.48529</medianDownload>
<lowerQuartileDownload>0.93568</lowerQuartileDownload>
<upperQuartileDownload>4.52148</upperQuartileDownload>
<medianUpload>0.46582</medianUpload>
<lowerQuartileUpload>0.25488</lowerQuartileUpload>
<upperQuartileUpload>0.62695</upperQuartileUpload>
<geographyId>02</geographyId>
<geographyName>Alaska</geographyName>
<accessingFrom>Home</accessingFrom>
</Results>
<Results>
<numberOfTests>5204</numberOfTests>
<medianDownload>1.22315</medianDownload>
<lowerQuartileDownload>0.45313</lowerQuartileDownload>
<upperQuartileDownload>2.87500</upperQuartileDownload>
<medianUpload>0.44531</medianUpload>
<lowerQuartileUpload>0.22656</lowerQuartileUpload>
<upperQuartileUpload>0.90430</upperQuartileUpload>
<geographyId>02</geographyId>
<geographyName>Alaska</geographyName>
<accessingFrom>Mobile</accessingFrom>
</Results>
<Results>
<numberOfTests>5204</numberOfTests>
<medianDownload>1.22315</medianDownload>
<lowerQuartileDownload>0.45313</lowerQuartileDownload>
<upperQuartileDownload>2.87500</upperQuartileDownload>
<medianUpload>0.44531</medianUpload>
<lowerQuartileUpload>0.22656</lowerQuartileUpload>
<upperQuartileUpload>0.90430</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>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>99</numberOfTests>
<medianDownload>1.52819</medianDownload>
<lowerQuartileDownload>0.96386</lowerQuartileDownload>
<upperQuartileDownload>3.29395</upperQuartileDownload>
<medianUpload>0.70600</medianUpload>
<lowerQuartileUpload>0.32813</lowerQuartileUpload>
<upperQuartileUpload>1.43400</upperQuartileUpload>
<geographyId>02</geographyId>
<geographyName>Alaska</geographyName>
<accessingFrom>Small_Business</accessingFrom>
</Results>
<Results>
<numberOfTests>99</numberOfTests>
<medianDownload>1.52819</medianDownload>
<lowerQuartileDownload>0.96386</lowerQuartileDownload>
<upperQuartileDownload>3.29395</upperQuartileDownload>
<medianUpload>0.70600</medianUpload>
<lowerQuartileUpload>0.32813</lowerQuartileUpload>
<upperQuartileUpload>1.43400</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.