DeveloperAPI » 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
{ "status":"OK", "responseTime":24, "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="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>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>