Public Broadband Data API

Query U.S. broadband data programmatically. Free for editorial and research use. No authentication required.

Overview

The InternetProviders.ai Public Broadband Data API provides free access to aggregated broadband metrics derived from 13.1 million FCC Broadband Data Collection records. The API supports queries by state, ZIP code, or national averages.

Base URL

https://www.internetproviders.ai/api/public/broadband-data

Authentication

None required

Rate Limit

100 requests per hour per IP

License

CC BY 4.0

Format

JSON

CORS

Enabled (all origins)

Endpoints

National Averages

?metric=national

Returns national-level broadband metrics including fiber coverage, average providers, pricing, and HHI market concentration data.

Example Request

curl "https://www.internetproviders.ai/api/public/broadband-data?metric=national"

Example Response

{
  "success": true,
  "data": {
    "scope": "national",
    "metrics": {
      "fiber_pct": 57,
      "avg_providers": 2.8,
      "avg_price_monthly": 64.99,
      "hhi_avg": 4600,
      "census_blocks_1_2_isps_pct": 42
    },
    "source": "FCC Broadband Data Collection (BDC)",
    "updated": "2026-03-15",
    "citation": "InternetProviders.ai Broadband Data API. Data sourced from FCC BDC. Licensed CC BY 4.0."
  },
  "license": "CC BY 4.0"
}

State-Level Data

?state=CA

Returns broadband metrics for a specific state. Use standard 2-letter state abbreviation.

Example Request

curl "https://www.internetproviders.ai/api/public/broadband-data?state=CA"

Example Response

{
  "success": true,
  "data": {
    "state": "CA",
    "metrics": {
      "cities_tracked": 856,
      "population_in_tracked_cities": 37254503,
      "metro_areas": 28
    },
    "source": "FCC Broadband Data Collection (BDC)",
    "updated": "2026-03-15",
    "detail_url": "https://www.internetproviders.ai/internet/ca/"
  },
  "license": "CC BY 4.0"
}

State Competition Metric

?state=CA&metric=competition

Returns competition-specific data for a state, including provider counts and metro area coverage.

Example Request

curl "https://www.internetproviders.ai/api/public/broadband-data?state=CA&metric=competition"

Example Response

{
  "success": true,
  "data": {
    "state": "CA",
    "metric": "competition",
    "summary": "CA has 856 tracked cities across 28 metro areas.",
    "detail_url": "https://www.internetproviders.ai/internet/ca/"
  },
  "license": "CC BY 4.0"
}

ZIP Code Data

?zip=90210

Returns broadband data for a specific 5-digit ZIP code, including nearby cities and population.

Example Request

curl "https://www.internetproviders.ai/api/public/broadband-data?zip=90210"

Example Response

{
  "success": true,
  "data": {
    "zip": "90210",
    "state": "CA",
    "cities": [
      "Beverly Hills"
    ],
    "metrics": {
      "population_nearby": 32701,
      "cities_count": 1
    },
    "detail_url": "https://www.internetproviders.ai/zip/90210/"
  },
  "license": "CC BY 4.0"
}

Response Headers

Header	Description
X-Attribution	Attribution notice included on every response
X-RateLimit-Limit	Maximum requests per window
X-RateLimit-Remaining	Requests remaining in current window
Access-Control-Allow-Origin	Set to * for cross-origin requests

Error Codes

Status	Meaning	Example
200	Success	Data returned successfully
400	Bad Request	Invalid state code or ZIP format
404	Not Found	No data for the requested ZIP/state
429	Rate Limited	Exceeded 100 requests/hour
500	Server Error	Internal error — please retry

Try It

Make a live API call from this page. Select an endpoint and click “Send Request.”

/api/public/broadband-data?

Click “Send Request” to see the API response.

Attribution & License

Data from this API is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0). When using this data, please include the following attribution:

Source: InternetProviders.ai Broadband Data API. Data sourced from FCC Broadband Data Collection. Licensed CC BY 4.0.