CoverageMap API

What is the CoverageMap API?

The CoverageMap API is a REST API that returns, for any list of United States locations, FCC coverage and signal strength data for each carrier and technology, crowdsourced real-world speed test data measured by CoverageMap users nearby, and summary scores that distill both into simple 0 to 10 ratings. Send coordinates or street addresses, choose the datasets, carriers and technologies you need, and receive a single JSON response for the whole batch.

It is built for production workflows: batch requests of up to 100 locations, predictable per-location billing, automatic FCC data refreshes, and enterprise options for regional carriers, volume discounts, service level agreements and dedicated support.

Data is available for AT&T, Verizon and T-Mobile across LTE and 5G. Additional and regional carriers are included on Enterprise agreements.

Datasets

Datasets are selected per request with the datasets field, so you only pay for what you use.

• fcc-coverage (1 unit per location): signal strength in dBm at the location and averaged within 0.5 km, 1 km and 2 km, plus the share of each radius that has coverage. Sourced from the FCC Broadband Data Collection and normalized by our processing pipeline.
• speed-tests (2 units per location): latency, download and upload with min, median, average and max, sample counts, failed test counts, an accuracy flag, the distance to the tests used, and the same summary at 0.5 km, 1 km and 2 km.
• summary (1 unit per location): simple 0 to 10 scores for overall quality, performance, coverage and reliability, computed from the FCC coverage and speed test data behind the scenes, with flags for full coverage and whether the scores are measured or estimated.

Sample Request

Authenticate with an Authorization: Bearer YOUR_API_KEY header and send a JSON body with the datasets, providers, technologies and locations you want. Locations can be latitude and longitude pairs or street addresses, which we geocode for you.

{
  "datasets": ["fcc-coverage", "speed-tests", "summary"],
  "providers": ["VZW", "ATT"],
  "technologies": ["lte", "5g"],
  "locations": [
    { "id": "store-1", "latitude": 39.95, "longitude": -75.16 },
    { "id": "store-2", "address": "1600 Pennsylvania Ave NW, Washington, DC 20500" }
  ]
}

Response Properties

Each location in the response includes its index, id, resolved coordinates and a coverage array with one entry per provider and technology.

Billing Units

Usage is measured in units per location per dataset. An FCC coverage lookup is 1 unit, a speed test lookup is 2 units, a summary lookup is 1 unit, and requesting all three datasets is 4 units per location. Every location returned without an error is billed, even when no coverage exists there, but speed tests are only billed for a location where speed test data is found.