Overview
The data behind The Graphite Lab's products, as an API. First series, Geo.
One key and one balance of rivets give you the data our own products run on. Geo is the first series: geocoding, routing, boundaries, postcodes, timezones and elevation for the United States and Canada. Rivets come with your Graphite Lab plan, and each request costs 1 rivet.
https://api.data.graphitelab.ai/v1Get started
| Step | Guide | What it covers |
|---|---|---|
| 1 | Quickstart | Sign in, create a key, make a first call. |
| 2 | Authentication | Send your key as a bearer token or apiKey, and the rate limit. |
| 3 | Pricing and rivets | 1 request costs 1 rivet. Rivets come from your plan. |
| 4 | Errors | The error body, status codes and what to retry. |
Also useful: Concepts for place IDs, rank and formats, and Coverage and data for sources, licences and known gaps.
Series
| Series | Status | Endpoint groups |
|---|---|---|
| Geo | Live | Geocoding, Boundaries, Postcode, Routing, Isolines, Timezone, Elevation |
| Roof data | Next | Not yet available |
| Video search | Next | Not yet available |
Geo endpoints
Each endpoint page has the parameters, an example request and response, and the behavior in prose. The API reference has the full schemas.
| Group | Endpoint | Method and path | Returns |
|---|---|---|---|
| Geocoding | Forward geocoding | GET /geocode/search | Coordinates and an address for text |
| Geocoding | Reverse geocoding | GET /geocode/reverse | The address at a point |
| Geocoding | Autocomplete | GET /geocode/autocomplete | Suggestions for partial text |
| Boundaries | Part of | GET /boundaries/part-of | Boundaries containing a place |
| Boundaries | Consists of | GET /boundaries/consists-of | Boundaries inside a place |
| Postcode | Postcode search | GET /postcode/search | A ZIP or postal code |
| Postcode | Postcode list | GET /postcode/list | Postcodes in an area |
| Routing | Routing | GET /routing | A route between waypoints |
| Routing | Route matrix | POST /routematrix | Times and distances, sources to targets |
| Routing | Map matching | POST /mapmatching | A GPS trace snapped to roads |
| Routing | Route planner | POST /routeplanner | Jobs assigned across agents |
| Isolines | Isoline | GET /isoline | The area reachable by time or distance |
| Timezone | Timezone | GET /timezone | Zone and UTC offset at a point |
| Timezone | Transitions | GET /timezone/transitions | DST and offset changes |
| Elevation | Elevation | POST /geodata/elevation | Elevation for locations |
Every answer comes from our own data: OpenStreetMap, NAD, StatCan NAR, Overture and others. See Coverage and data.