Skip to main content
GET
Get network map
This public endpoint needs no API key or user token. It returns device counts per area, in three tiers, and never returns a device’s or profile’s location:
  • Areas of 0.1 degree (about 11 km) with at least three devices.
  • Devices left over are rolled up into areas of 1 degree (about 111 km), published with at least three devices.
  • Devices still left over go into wider regions of 5 degrees (about 550 km), published with any count and marked "coarse": true. A wider region places a device only within a region hundreds of kilometers across.
Every device is counted in exactly one area, so devices_published equals devices_total. format=cells returns every tier as {lat, lon, count, size_deg} (plus coarse on wider regions). The default point list (one {lat, lon} per device at its area’s center) leaves wider regions out; nodes_total gives its length.

Pagination

Both formats are paginated. page starts at 1 and limit defaults to 50, so a request without them returns the first 50 points. Each response reports the page and limit it applied and how many items it returned. Request further pages until returned is less than limit, or size one request from nodes_total or cells_total:
Responses are cached for 60 seconds. Each client IP can make 60 requests a minute; the ratelimit-remaining header shows what is left, and a 429 carries Retry-After.

Query Parameters

page
integer
default:1

Page number, starting at 1. Defaults to 1.

Required range: x >= 1
limit
integer
default:50

Items per page: points in the default format, areas with format=cells. Defaults to 50; larger values are capped by the service.

Required range: x >= 1
format
enum<string>

Set to cells to return every area with its count instead of one point per device.

Available options:
cells
reverse
boolean
default:false

Set to true to page from the end of the list.

Response

Success

message
string
required
data
object
required