> ## Documentation Index
> Fetch the complete documentation index at: https://docs.areahub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Make your first request in under five minutes.

## 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](mailto:sales@areahub.com).

Your key looks like this:

```
areahub_live_bb4856406e27f6b79a384edadcc25806c94737837825b9138adb9e42e95c6e
```

<Warning>
  **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.
</Warning>

<a
  href="mailto:sales@areahub.com"
  style={{
display: "block",
paddingTop: "8px",
paddingBottom: "8px",
backgroundColor: "#1B3A6B",
color: "white",
borderRadius: "15px",
fontWeight: 600,
marginTop: "30px",
textDecoration: "none",
width: "full",
textAlign: "center",
}}
>
  Get an API Key
</a>

## 2. Make a request

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

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.areahub.com/v1/wildfire/risk?lat=39.72&lng=-121.83" \
    -H "X-API-Key: YOUR_API_KEY"
  ```

  ```python Python theme={null}
  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())
  ```

  ```javascript Node.js theme={null}
  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);
  ```
</CodeGroup>

## 3. Read the response

```json theme={null}
{
  "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](/reference/topics).
* **`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](/concepts/credits).

## 4. See all topics at once

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

```bash theme={null}
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:

```json theme={null}
{
  "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, ... }
}
```

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

## Next steps

<CardGroup cols={2}>
  <Card title="Topics Reference" icon="list" href="/reference/topics">
    All 37 topics and what each returns.
  </Card>

  <Card title="Credits" icon="coins" href="/concepts/credits">
    How billing and quotas work.
  </Card>
</CardGroup>