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 Center latitude of the search area in decimal degrees, WGS 84.
Center longitude of the search area in decimal degrees, WGS 84.
Search radius around the center point in kilometres. All hotspots detected within this radius are included in the response.
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: Value Description 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 Center latitude echoed from the request.
Center longitude echoed from the request.
Search radius echoed from the request.
Look-back period in days echoed from the request.
Total number of hotspots detected within the search area.
Array of individual fire hotspot detections. Empty when no fires are detected. Show Hotspot object properties
Latitude of the hotspot centroid.
Longitude of the hotspot centroid.
Brightness temperature at the fire pixel in Kelvin (VIIRS) or channel 21/22 brightness (MODIS).
Fire Radiative Power in megawatts. Higher values indicate more intense fires.
Acquisition date in YYYY-MM-DD format.
Acquisition time in HHMM format (UTC).
Satellite name. Example: "N" (NOAA-20), "S" (Suomi NPP), "T" (Terra), "A" (Aqua).
Detection confidence. For VIIRS: "low", "nominal", or "high". For MODIS: a numeric percentage string.
FIRMS data source that produced this detection, matching the source query parameter.
Cache metadata for the FIRMS data used in this response. true if data was fetched from NASA FIRMS on this request.
ISO 8601 timestamp of when this cache entry was stored.
true if a stale cache entry was served as a fallback due to an upstream error.
Error codes Code Description 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 } }