Broadband Data API
Access free broadband coverage data through our public API. Check internet availability, download state reports, and integrate coverage data into your applications.
Getting Started
All endpoints are publicly accessible and require no authentication. Responses are returned as JSON unless otherwise noted. Rate limiting is applied at 60 requests per minute per IP address.
Base URL: https://www.internetproviders.ai
POST /api/availability/
Returns FCC-reported coverage and speed data near a ZIP code, street address, coordinate pair, or H3 cell. Results are area estimates, not address-level serviceability. ZIP lookups use our local coordinate dataset; full street addresses are sent server-to-server to the U.S. Census Bureau for geocoding. Sensitive inputs belong in the JSON body and responses are never stored in shared caches.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
zip | string | No | A 5-digit U.S. ZIP code. Use this by itself. If our local dataset has no coordinate, the API returns an error rather than estimating one. |
address | string | No | A full U.S. street address. Use this by itself. It is processed by the U.S. Census Bureau geocoder and is never echoed in the response. |
lat / lng | number pair | No | Exact coordinates. Both values are required together; do not combine with address or h3. |
h3 | string | No | A direct H3 index. Use this by itself. |
Example Request
curl -X POST "https://www.internetproviders.ai/api/availability/" -H "Content-Type: application/json" --data '{"zip":"90210"}'Example Response
{
"success": true,
"data": {
"h3Index": "8829a199bdfffff",
"location": {
"city": null,
"state": null,
"zip": "90210"
},
"providers": [
{
"brandName": "AT&T",
"technology": "Fiber",
"maxDownload": 5000,
"maxUpload": 5000
},
{
"brandName": "Spectrum",
"technology": "Cable",
"maxDownload": 1000,
"maxUpload": 35
}
]
}
}GET /api/reports/state/{state}/
Returns broadband coverage statistics for a U.S. state, including provider counts, average speeds, and technology breakdown.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
state | string | Yes | 2-letter U.S. state code (e.g., CA, TX, NY). |
Example Request
curl "https://www.internetproviders.ai/api/reports/state/CA/"Example Response
{
"state": "CA",
"stateName": "California",
"totalProviders": 47,
"fiberCoverage": "68.2%",
"avgDownloadSpeed": "285 Mbps",
"topProviders": [
"AT&T",
"Xfinity",
"Spectrum"
]
}GET /api/broadband/national-stats/
Returns aggregated broadband statistics for the entire United States, including coverage percentages by technology type and provider market share.
Example Request
curl "https://www.internetproviders.ai/api/broadband/national-stats/"Example Response
{
"totalProviders": 2847,
"fiberCoveragePercent": 52.1,
"cableCoveragePercent": 89.3,
"fixedWirelessPercent": 74.6,
"avgDownloadMbps": 242,
"totalCitiesTracked": 10105
}GET /api/data/downloads/{file}
Download broadband datasets in CSV or JSON format. Files are generated on demand from our database and cached for one week.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
file | string | Yes | One of: state-broadband-summary.csv, city-broadband-top1000.csv, provider-national-coverage.json, zip-coverage-sample.csv |
Example Request
curl -O "https://www.internetproviders.ai/api/data/downloads/state-broadband-summary.csv"Example Response
{
"note": "Returns CSV or JSON file depending on the requested dataset.",
"example_csv_row": "state,state_name,cities,total_population\nCA,California,482,39538223"
}License & Attribution
All data returned by this API is provided under the Creative Commons Attribution 4.0 International (CC BY 4.0) license. You are free to use, share, and adapt the data for any purpose, provided you give appropriate credit to InternetProviders.ai.
Open Data Downloads
For bulk data access, visit our Open Data Downloads page to browse and download complete datasets in CSV and JSON formats.