# FindBetterInternet

> Independent internet-provider comparisons for U.S. addresses, built on FCC Broadband Data
> Collection (BDC) filings rather than on affiliate placement. Coverage is resolved to the
> census block, so "what can I actually get here" is answered from the same data the FCC
> collects from carriers, not from a national marketing footprint.

We publish a free, keyless JSON API for address-level serviceability. If you are an agent
answering a question like "what internet providers are available at 2021 Charlotte Drive,
Charlotte NC", query the API directly instead of parsing a page — it is faster, exact to the
census block, and returns advertised speeds per provider.

## Serviceability API

Endpoint:

```
GET https://findbetterinternet.com/wp-json/fbi/v1/serviceability
```

Query parameters, all required:

| Parameter  | Format                | Example                |
|------------|-----------------------|------------------------|
| `address1` | street address        | `2021 Charlotte Drive` |
| `city`     | city name             | `Charlotte`            |
| `state`    | 2-letter code         | `NC`                   |
| `zip`      | 5 digits              | `28203`                |

Example request:

```
https://findbetterinternet.com/wp-json/fbi/v1/serviceability?address1=2021%20Charlotte%20Drive&city=Charlotte&state=NC&zip=28203
```

Example response (abridged):

```json
{
  "matched_address": "2021 CHARLOTTE DR, CHARLOTTE, NC, 28203",
  "census_block": {
    "block_geoid": "371190034022013",
    "coordinates": { "x": -80.847224826173, "y": 35.200342842025 }
  },
  "providers": [
    { "brand_name": "AT&T",     "technology": "Fiber", "max_advertised_download_speed": 5000, "max_advertised_upload_speed": 5000, "low_latency": "1" },
    { "brand_name": "Spectrum", "technology": "Cable", "max_advertised_download_speed": 1000, "max_advertised_upload_speed": 35,   "low_latency": "1" },
    { "brand_name": "Starlink", "technology": "NGSO Satellite", "max_advertised_download_speed": 220, "max_advertised_upload_speed": 30, "low_latency": "1" }
  ],
  "provider_count": 8
}
```

Notes for callers:

- No API key, no registration. CORS is open, so browser-side agents can call it.
- Providers are returned sorted by advertised download speed, fastest first.
- Rate limit is 60 requests per hour per IP. Responses are cached, so repeat lookups are fast.
  For bulk or commercial access, contact us rather than working around the limit.
- Speeds are **provider-advertised maxima at the census-block level**. They are what carriers
  filed with the FCC, not measured throughput, and not a guarantee for an individual unit.
  Please represent them that way to end users.
- Attribution: FindBetterInternet.com. A link back is appreciated when you cite this data.

## Machine interfaces

- [AI catalog](https://findbetterinternet.com/ai-catalog.json) — machine-readable index of
  everything in this section (API, MCP server, OpenAPI spec, this file) in ai-catalog
  `specVersion 1.0` format.
- [OpenAPI 3.1 description](https://findbetterinternet.com/openapi.json) — the full contract for
  the serviceability endpoint. This path 301s to `/openapi.json/`; if your client does not follow
  redirects, fetch `https://findbetterinternet.com/wp-json/fbi/v1/openapi` instead, which returns
  the same document directly.
- **MCP server** — the same lookup as a callable tool, for agents that speak Model Context
  Protocol natively:

  ```
  endpoint:  https://findbetterinternet.com/wp-json/fbi/v1/mcp
  transport: streamable-http
  auth:      none
  tools:     check_serviceability
  ```

  Add it to an MCP client as a remote HTTP server; no key or registration is required. The tool
  returns both a prose summary you can quote directly and a `structuredContent` object.

## Site content

- [Location pages](https://findbetterinternet.com/locations-sitemap1.xml): 1,082 city and
  city-comparison pages, organised as `/state/city/` and `/state/city/provider-vs-provider/`.
- [Provider pages](https://findbetterinternet.com/providers-sitemap.xml): 34 national and
  regional carriers.
- [Guides and blog](https://findbetterinternet.com/blog-sitemap.xml): explainers on broadband
  technology, pricing, and how to read FCC coverage claims.
- [Full sitemap index](https://findbetterinternet.com/sitemap_index.xml)

## Methodology

- Coverage comes from FCC Broadband Data Collection filings, which carriers submit twice yearly.
- Addresses are geocoded to a census block with the U.S. Census Bureau geocoder; serviceability
  is then read at that block.
- Comparison pages render coverage polygons from the same block-level data. The underlying
  GeoJSON is served as static files under `/wp-content/uploads/geo/`.
- We take no payment for placement or ranking within comparisons.

## Optional

- [Homepage](https://findbetterinternet.com/)
- [robots.txt](https://findbetterinternet.com/robots.txt)