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
- Open the FIRMS MAP_KEY page.
- Enter your email address and submit. FIRMS emails the key to you.
- 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.