Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.climatifai.com/llms.txt

Use this file to discover all available pages before exploring further.

The fire hotspots endpoint queries NASA FIRMS (Fire Information for Resource Management System) for active fire detections within a circular area around a point of interest. Each hotspot record includes the satellite brightness, fire radiative power (FRP), acquisition time, and confidence level. You can use this endpoint to assess current fire activity near a field before planting or as an input to a broader risk assessment workflow.

​
Endpoint

GET api.climatifai.com/fires/hotspots

​
Parameters

​
lat
float
required
Center latitude of the search area in decimal degrees, WGS 84.
​
lon
float
required
Center longitude of the search area in decimal degrees, WGS 84.
​
radius_km
float
default:"100"
Search radius around the center point in kilometres. All hotspots detected within this radius are included in the response.
​
days
integer
default:"5"
Number of days to look back from the current date. Must be between 1 and 5. This constraint is imposed by the FIRMS Area API.
​
source
string
default:"VIIRS_SNPP_NRT"
NASA FIRMS data source to query. Accepted values:
ValueDescription
VIIRS_SNPP_NRTVIIRS sensor on Suomi NPP satellite (near-real-time)
MODIS_NRTMODIS sensor (near-real-time, lower resolution)
VIIRS_NOAA20_NRTVIIRS sensor on NOAA-20 satellite (near-real-time)

​
Response

​
lat
float
required
Center latitude echoed from the request.
​
lon
float
required
Center longitude echoed from the request.
​
radius_km
float
required
Search radius echoed from the request.
​
days
integer
required
Look-back period in days echoed from the request.
​
count
integer
required
Total number of hotspots detected within the search area.
​
hotspots
array
required
Array of individual fire hotspot detections. Empty when no fires are detected.
​
_cache
object
Cache metadata for the FIRMS data used in this response.

​
Error codes

CodeDescription
502Upstream error from NASA FIRMS. The detail field contains the original error message.

​
Example

curl "https://api.climatifai.com/fires/hotspots?lat=19.4326&lon=-99.1332&radius_km=150&days=3&source=VIIRS_SNPP_NRT"

{
  "lat": 19.4326,
  "lon": -99.1332,
  "radius_km": 150,
  "days": 3,
  "count": 2,
  "hotspots": [
    {
      "lat": 19.21,
      "lon": -99.47,
      "brightness": 331.2,
      "frp": 8.4,
      "acq_date": "2026-05-17",
      "acq_time": "0648",
      "satellite": "S",
      "confidence": "nominal",
      "source": "VIIRS_SNPP_NRT"
    },
    {
      "lat": 19.58,
      "lon": -98.91,
      "brightness": 305.7,
      "frp": 3.1,
      "acq_date": "2026-05-16",
      "acq_time": "1812",
      "satellite": "N",
      "confidence": "low",
      "source": "VIIRS_SNPP_NRT"
    }
  ],
  "_cache": {
    "fresh": true,
    "cached_at": "2026-05-18T10:15:00Z",
    "stale": false
  }
}