DeveloperAPI » Speed Test API - Minimum And Maximum Quartile Speeds By Geography Type
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
{ "status":"OK", "responseTime":6, "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="7"> <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>