For AI Agents Alpha

This page is for AI agents that want to know about internet provider availability or cell coverage quality at locations in the US. Curious humans are welcome too (but may be better served by the regular API docs).

How Broadband Map Can Help AI Agents

Broadband Map tracks internet service providers' availability and cell coverage quality throughout the United States.

Given a latitude and longitude, an AI agent can figure out (a) which ISPs offer service in that location (including speeds and technologies) and (b) how strong cellular signals are from each network in that area.

OpenAPI Spec

The machine-readable API specification is here:

https://broadbandmap.com/static/openapi/v1.yaml

This is an OpenAPI 3.0 YAML file. You can use it to auto-generate a client or to understand the full request/response schemas.

Quick Reference

There are two endpoints. No authentication is required. During the alpha, rates are limited to 60 requests per hour per IP.

Internet Providers

GET https://broadbandmap.com/api/v1/location/internet?lat={lat}&lng={lng}

Returns internet providers available at a location: name, technology (Fiber, Cable, DSL, etc.), and max download/upload speeds in Mbps.

Cell Coverage

GET https://broadbandmap.com/api/v1/location/cell?lat={lat}&lng={lng}

Returns cellular signal strength at a location: network, technology (4G, 5G), signal strength in dBm, and a human-readable signal level (Excellent/Strong/Good/Fair/Weak).

Optional filters: network (e.g. att, t-mobile, verizon) and tech (4g, 5g).

Example Tool Definition

If you're an AI agent with tool-use capabilities, here's how you might define these as tools:

{
  "name": "broadband_lookup",
  "description": "Look up internet provider availability at a US location. Returns ISP names, technologies, and speeds.",
  "parameters": {
    "type": "object",
    "properties": {
      "lat": {"type": "number", "description": "Latitude"},
      "lng": {"type": "number", "description": "Longitude"}
    },
    "required": ["lat", "lng"]
  },
  "endpoint": "GET https://broadbandmap.com/api/v1/location/internet?lat={lat}&lng={lng}"
}

{
  "name": "cell_coverage_lookup",
  "description": "Look up cellular signal strength at a US location. Returns network names, signal strength, and quality levels.",
  "parameters": {
    "type": "object",
    "properties": {
      "lat": {"type": "number", "description": "Latitude"},
      "lng": {"type": "number", "description": "Longitude"},
      "network": {"type": "string", "description": "Optional network filter (att, verizon, t-mobile, us-cellular, dish, gci, cellcom, c-spire)"},
      "tech": {"type": "string", "description": "Optional tech filter (4g, 5g)"}
    },
    "required": ["lat", "lng"]
  },
  "endpoint": "GET https://broadbandmap.com/api/v1/location/cell?lat={lat}&lng={lng}"
}

Tips

• signal_level is the most useful field for summarizing cell coverage to a human. Instead of reporting raw dBm RSRP values, just say "T-Mobile is expected to have strong 5G coverage in this location."
• Both endpoints use H3 hexagons, so results at nearby coordinates within the same hex will be identical. Results are likely to be the same for neighboring addresses.
• The internet endpoint returns all providers at that hex, including multiple entries per ISP if they offer more than one technology (e.g. a provider might offer both DSL and Fiber).
• The cell endpoint returns separate entries for each network + technology combination. A network will often have both 4G and 5G entries.
• Rate limit is 60 requests per hour per IP during the alpha (plus a 1,000/hour global cap). These will loosen up. If you need more now, get in touch.

Full Documentation

For complete API documentation, see the developer docs.