# Lightningmaps — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Track real-time lightning strikes across the globe with precise coordinates, timestamps, and accuracy measurements from the Blitzortung.org network. Query live strike data and access information about detector stations worldwide to monitor weather patterns and atmospheric activity as it happens.

**Category:** Weather | **Website:** [lightningmaps.org/](https://lightningmaps.org/) | **Docs:** [parse.bot/marketplace/d8e177e8-8369-480c-94de-0357b214f242/lightningmaps-org-api](https://parse.bot/marketplace/d8e177e8-8369-480c-94de-0357b214f242/lightningmaps-org-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-lightningmaps-org-api-d8e177e8/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_stations

Retrieve lightning detector station data for a geographic region. Returns station locations, cities, countries, altitudes, and status for all Blitzortung network detectors in the specified region. Each station includes its geographic coordinates and metadata. The timeid reflects a 15-minute time bucket used for cache management.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `region` | string | No | Geographic region for station lookup. Accepted values: 'europe', 'oceania', 'america'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lightningmaps-org-api-d8e177e8/get_stations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region":"<string>"}'
```

### get_strikes

Get real-time lightning strikes via WebSocket connection. Connects to the live data feed and collects strikes for a configurable duration (1-60 seconds). Supports geographic bounding box filtering. Returns strike locations with latitude, longitude, timestamps, deviation, and metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `duration` | integer | No | Duration in seconds to collect strikes (1-60) |
| `east` | number | No | Eastern longitude bound for filtering |
| `north` | number | No | Northern latitude bound for filtering |
| `south` | number | No | Southern latitude bound for filtering |
| `src_mask` | integer | No | Source bitmask for lightning networks (4=Blitzortung default, 7=all) |
| `west` | number | No | Western longitude bound for filtering |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lightningmaps-org-api-d8e177e8/get_strikes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"duration":"<integer>","east":"<number>","north":"<number>","south":"<number>","src_mask":"<integer>","west":"<number>"}'
```

### get_strikes_xhr

Retrieve recent lightning strikes from the Blitzortung network via HTTP polling. Returns the most recent batch of strikes with latitude, longitude, deviation, delay, and which detector stations participated in each detection. The response includes a size_marker for subsequent polling and a recommended wait interval. Each strike carries station participation data mapping station IDs to signal metadata when include_stations is true.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `include_stations` | boolean | No | Whether to include station participation data for each strike |
| `src_mask` | integer | No | Source bitmask for lightning networks (4=Blitzortung default) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lightningmaps-org-api-d8e177e8/get_strikes_xhr \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"include_stations":"<boolean>","src_mask":"<integer>"}'
```