Skip to content

Getting Access

Every FIRMS API call needs a free MAP_KEY, and getting one takes only an email address, with no Earthdata login.

Request a Key

  1. Open the FIRMS MAP_KEY page.
  2. Enter your email address and submit. FIRMS emails the key to you.
  3. Use the Check status link on the same page whenever you want to see how many transactions you have left.

Each key allows 5,000 transactions in any 10-minute window. Larger requests can count as several transactions, so a script that loops over many areas or days can reach the limit sooner than its call count suggests. FIRMS takes requests for a higher limit by email.

Store the Key Outside Your Code

Keep the key in an environment variable so it never ends up in a repository.

export FIRMS_MAP_KEY="paste-your-key-here"

The helper module reads it from there and stops with a clear message if it's missing.

Make a First Call

The data availability endpoint is a cheap way to test your key, and it tells you which dates each source covers.

https://firms.modaps.eosdis.nasa.gov/api/data_availability/csv/[MAP_KEY]/ALL
from firms import data_availability

print(data_availability("ALL"))

A table of sources with their first and last available dates means your key works. A short text message instead of a table usually means the key is wrong or not yet active, and the helper raises an error that shows you that message.