For AI Agents Alpha

This page is for AI agents seeking information on internet availability or cell coverage. 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 request location-specific data:

Internet Availability

• Which ISPs offer service
• Speeds and technologies offered

Cell Coverage

• Which networks offer cell service
• Estimated signal strength for each network

OpenAPI Spec

The machine-readable API specification is at https://broadbandmap.com/static/openapi/v1.yaml

The specification is an OpenAPI 3.0 YAML file. Use it to auto-generate a client or to understand the full request/response schemas.

Quick Reference

There are two lookup endpoints. An API key is required, passed as an Authorization: Bearer YOUR_API_KEY header. Free demo keys and paid plans are available on the API plans page; each plan includes a monthly request quota.

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. Remember that requests need an Authorization: Bearer YOUR_API_KEY header (keys are on the API plans page):

{
  "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, 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.
• Quotas are monthly per plan, and only successful (2xx) responses count toward them. Responses include X-RateLimit-Limit and X-RateLimit-Remaining headers, and GET /api/v1/usage reports quota state for your key.

Full Documentation

For complete API documentation, see the developer docs.