Quickstart

1. Get your API key

API keys are issued by our team during onboarding. If you don’t have one yet, contact your account manager or sales@areahub.com. Your key looks like this:

areahub_live_bb4856406e27f6b79a384edadcc25806c94737837825b9138adb9e42e95c6e

Your key is shown exactly once, at creation. We store only a hash of it and cannot recover the original. If you lose your API key, we issue a new key and revoke the old key.

Get an API Key

2. Make a request

For example, ask for wildfire results for a location near Chico, California:

curl "https://api.areahub.com/v1/wildfire/risk?lat=39.72&lng=-121.83" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.areahub.com/v1/wildfire/risk",
    params={"lat": 39.72, "lng": -121.83},
    headers={"X-API-Key": "YOUR_API_KEY"},
)

print(response.json())

const response = await fetch(
  "https://api.areahub.com/v1/wildfire/risk?lat=39.72&lng=-121.83",
  { headers: { "X-API-Key": process.env.YOUR_API_KEY } },
);

const data = await response.json();
console.log(data);

3. Read the response

{
  "data": {
    "topic": "wildfire",
    "location": { "lat": 39.72, "lng": -121.83 },
    "result": {
      "value": {
        "title": "Wildfires",
        "rating": "Relatively Low",
        "score": 75.355562954859,
        "frequency": 0.0018872465061567
      },
      "details": { current: […], historical: […], perimeters: […] }
    }
  },
  "meta": {
    "request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "timestamp": "2026-07-14T16:31:55.009Z",
    "credit_cost": 1
  }
}

Three things to note:

value is the primary answer. Its shape depends on the topic — see Topics Reference.
details is supporting data (nearby records, historical events). It’s null for many topics.
meta.credit_cost tells you what this request cost. Credits are only charged on success - see Credits.

4. See all topics at once

Rather than 37 separate calls, ask for the full bundle:

curl "https://api.areahub.com/v1/bundle/enterprise?lat=40.71&lng=-74.00" \
  -H "X-API-Key: YOUR_API_KEY"

This returns all 37 topics keyed by slug:

{
  "data": {
    "location": { "lat": 40.71, "lng": -74.0 },
    "topics": {
      "wildfire":   { "value": { "rating": "No Rating", ... }, "details": {...} },
      "brownfield": { "value": 60, "details": [...] },
      "airQuality": { "value": { "metric": "Unhealthy for Sensitive Groups", ... }, "details": null },
	  ...
    }
  },
  "meta": { "credit_cost": 35, ... }
}

Enterprise Bundle responses are large — typically 5–7 MB. Make sure your HTTP client isn’t configured with a smaller response size limit.

Getting Started

Core Concepts

Reference

1. Get your API key

2. Make a request

3. Read the response

4. See all topics at once

Next steps

Topics Reference

Credits

​1. Get your API key

​2. Make a request

​3. Read the response

​4. See all topics at once

​Next steps

Topics Reference

Credits

1. Get your API key

2. Make a request

3. Read the response

4. See all topics at once

Next steps