Skip to main content

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

GET /api/availability?address={zip_or_address}

Returns a list of internet service providers available at a given ZIP code or street address, including plan details, speeds, and pricing.

Parameters

NameTypeRequiredDescription
addressstringYesA 5-digit ZIP code or full street address.

Example Request

curl "https://www.internetproviders.ai/api/availability?address=90210"

Example Response

{
  "providers": [
    {
      "name": "AT&T Fiber",
      "technology": "Fiber",
      "maxSpeed": "5000 Mbps",
      "startingPrice": "$55.00/mo"
    },
    {
      "name": "Spectrum",
      "technology": "Cable",
      "maxSpeed": "1000 Mbps",
      "startingPrice": "$49.99/mo"
    }
  ]
}

GET /api/reports/state/{state}

Returns broadband coverage statistics for a U.S. state, including provider counts, average speeds, and technology breakdown.

Parameters

NameTypeRequiredDescription
statestringYes2-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

NameTypeRequiredDescription
filestringYesOne 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,population,fiber_coverage\nCA,California,482,39538223,68.2"
}

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.