The Ambee natural disasters API delivers comprehensive natural disaster data, including earthquakes, cyclones, floods, volcanoes, droughts, wildfires, and other calamities.
name | event type | description |
---|---|---|
Tsunamis | TN | Tsunamis and related sea waves |
Earthquake | EQ | Earthquakes and related seismic activities |
Tropical Cyclones | TC | Tropical cyclones including hurricanes, typhoons & cyclones |
Wildfires | WF | Wildfires and fire related events which includes widlfires, burn off, bushfire, fires, pre fire alerts, structure fire. |
Floods | FL | Floods including flash floods and general flooding |
Extreme Temperature | ET | Extreme temperature events including heat waves, cold waves, hot day conditions, etc. |
Droughts | DR | Droughts and prolonged dry conditions |
Severe storms | SW | Severe storms, thunderstorms & related weather phenomena which includes lightning, gusty winds, thunder shower, violent wind, storm surge, hailstorm, heavy rain and light rain |
Sea Ice | SI | Sea ice conditions |
Volcano | VO | Volcanic activities and eruptions |
Landslides | LS | Landslides, avalanches and related ground movement |
Miscellaneous | Misc | Miscellaneous events including unique imagery & technical disasters. |
The table below provides descriptions for the possible values of the ‘details’ response parameter. The ‘details’ attribute offers additional information for each type of disaster event. You can find this response parameter under the eventwise search endpoint.
field | description |
---|---|
event_magnitude | The measured magnitude of the event |
active | Indicates whether the earthquake event is currently active or ongoing. |
alert_level | The level of alert issued for the earthquake, indicating its severity. |
businesses_destroyed | The impact on businesses due to the earthquake. |
country | The country where the earthquake occurred. |
country_code | The ISO code representing the country of the earthquake. |
death | The total number of fatalities caused by the earthquake. |
depth | The depth at which the earthquake occurred. |
earthquake_magnitude | The measured magnitude of the earthquake. |
episode_alert_level | The alert level for a specific episode within the earthquake event. |
episode_alert_score | A score representing the severity of the earthquake episode. |
event_date | The date when the earthquake occurred. |
event_description | A brief description of the earthquake event. |
event_magnitude | The magnitude of the specific earthquake event. |
event_name | The name or identifier of the earthquake event. |
event_place | The location or region where the earthquake took place. |
exposed_population | The estimated population exposed to the earthquake. |
homes_destroyed | The number of homes impacted as a result of the earthquake. |
injuries | The total number of injuries reported due to the earthquake. |
inserted_at | The timestamp when the earthquake data was recorded in the system. |
insurance_cost | Estimated cost of insurance claims due to the earthquake damage. |
introduction | An introduction or overview of the earthquake event. |
lat_lon | The latitude and longitude coordinates of the earthquake's epicenter. |
severity | The overall severity of the earthquake event. |
severity_description | A detailed description of the earthquake's severity. |
unit | The unit of measurement for the earthquake data (e.g., magnitude, depth). |
active | Indicates whether the wildfire event is currently active or ongoing. |
alert_level | The level of alert issued for the wildfire, indicating its severity. |
burned_area | The total area burned by the wildfire, usually measured in hectares or acres. |
businesses_destroyed | The number of businesses destroyed due to the wildfire. |
certainty | The confidence level in the occurrence of the wildfire event. |
country | The country where the wildfire occurred. |
country_code | The ISO code that represents the country of the wildfire occurrence. |
death | The total number of fatalities caused by the wildfire. |
duration | The total duration of the wildfire event. |
episode_alert_level | The alert level for a specific episode within the wildfire event. |
episode_alert_score | A numerical score representing the severity of the wildfire episode. |
event_date | The date when the wildfire occurred. |
event_description | A brief description of the wildfire event. |
event_magnitude | The magnitude or intensity of the wildfire. |
event_name | The name or identifier of the wildfire event. |
event_place | The location or region where the wildfire took place. |
event_status | The current status of the wildfire event (e.g., contained, ongoing). |
homes_destroyed | The number of homes destroyed as a result of the wildfire. |
injuries | The total number of injuries reported due to the wildfire. |
instruction | Instructions or guidance issued to the public regarding the wildfire. |
insurance_cost | The estimated cost of insurance claims due to the wildfire damage. |
introduction | An introduction or overview of the wildfire event. |
more_info | Additional information or resources related to the wildfire. |
people_affected | The estimated number of people affected by the wildfire. |
sender | The entity or organization that sent the wildfire alert. |
severity | The overall severity of the wildfire event. |
severity_description | A detailed description of the wildfire's severity. |
start_date_and_last_detection | The start date of the wildfire and the date of its last detection. |
unit | The unit of measurement for the wildfire data (e.g., area burned, duration). |
urgency | The level of urgency for responding to the wildfire event. |
active | Indicates whether the event is currently active or ongoing. |
alert_level | The level of alert issued for the event, indicating its severity. |
businesses_destroyed | The number of businesses destroyed due to the event. |
certainty | The confidence level in the occurrence of the event. |
country | The country where the event occurred. |
country_code | The ISO code representing the country of the event occurrence. |
death | The total number of fatalities caused by the event. |
episode_alert_level | The alert level for a specific episode within the event. |
episode_alert_score | A numerical score representing the severity of the event episode. |
event_date | The date when the event occurred. |
event_description | A brief description of the event. |
event_name | The name or identifier of the event. |
event_place | The specific location or region where the event took place. |
event_status | The current status of the event. |
exposed_population | The estimated population exposed to the event. |
homes_destroyed | The number of homes destroyed as a result of the tropical cyclone. |
injuries | The total number of injuries reported due to the event. |
instruction | Instructions or guidance issued to the public regarding the event. |
insurance_cost | The estimated cost of insurance claims due to the event. |
introduction | An introduction or overview of the event. |
maximum_storm_surge | The highest storm surge level recorded during the tropical cyclone. |
maximum_wind_speed | The maximum wind speed recorded during the tropical cyclone. |
polygon_date | The date when the geographical polygon data was recorded. |
sender | The entity or organization that sent the event alert. |
severity | The overall severity of the event. |
severity_description | A detailed description of the event's severity. |
start_date_and_last_detection | The start date of the event and the date of its last detection. |
unit | The unit of measurement for the event data. |
urgency | The level of urgency for responding to the event. |
vulnerability | The level of vulnerability of the affected area to the tropical cyclone. |
duration | The total duration of the drought event. |
impact | The overall impact of the drought on the affected area. |
displaced | The number of people displaced due to the flood. |
homes_destroyed | The number of homes destroyed as a result of the event. |
event_magnitude | The size or intensity of the volcanic event. |
exposed_population | The estimated number of people affected by the volcano. |
lat_lon | The latitude and longitude coordinates of the volcano. |
max_volcano_explosivity_index_vei | The maximum possible VEI for the volcano. |
population_exposure_index_pai | A measure of the potential population impact. |
event_magnitude | The size or intensity of the event. |
Offers real-time natural disaster data with insights into episode-wise severity, risk levels, and more.
Retrieve Natural Disasters data using geographic coordinates (latitude/longitude).
x-api-key
Content-type
Accept-Language
lat
lng
eventType
limit
page
https://api.ambeedata.com/disasters/latest/by-lat-lng?lat=-15.76166996&lng=-72.48771045489497&limit=1&page=1
const http = require("https");
const options = {
"method": "GET",
"hostname": "api.ambeedata.com",
"port": null,
"path": "/disasters/latest/by-lat-lng?lat=-15.76166996&lng=-72.48771045489497",
"headers": {
"x-api-key": "API_KEY",
"Content-type": "application/json"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
Retrieve natural disaster data using specific continent codes.
x-api-key
Content-type
Accept-Language
continent
eventType
limit
page
https://api.ambeedata.com/disasters/latest/by-continent?continent=NAR&page=1&limit=1
const http = require("https");
const options = {
"method": "GET",
"hostname": "api.ambeedata.com",
"port": null,
"path": "/disasters/latest/by-continent?continent=NAR&page=1&limit=1",
"headers": {
"x-api-key": "API_KEY",
"Content-type": "application/json"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
Retrieve natural disaster data using specific country codes.
x-api-key
Content-type
Accept-Language
eventType
limit
page
https://api.ambeedata.com/disasters/latest/by-country-code?countryCode=IND&limit=1&page=1
const http = require("https");
const options = {
"method": "GET",
"hostname": "api.ambeedata.com",
"port": null,
"path": "/disasters/latest/by-country-code?countryCode=IND&limit=1&page=1",
"headers": {
"x-api-key": "API_KEY",
"Content-type": "application/json"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
Access historical natural disaster data to understand the patterns and trends of natural disasters in the past to create a safer future.
Retrieve natural disaster data using geographic coordinates (latitude/longitude)
x-api-key
Content-type
Accept-Language
lat
lng
from
to
eventType
page
limit
https://api.ambeedata.com/disasters/history/by-lat-lng?lat=40.4549&lng=36.3025&from=2024-05-31 12:00:00&to=2024-07-31 08:00:00&limit=1&page=1
const http = require("https");
const options = {
"method": "GET",
"hostname": "api.ambeedata.com",
"port": null,
"path": "/disasters/history/by-lat-lng?lat=40.4549&lng=36.3025&from=2024-05-31 12:00:00&to=2024-07-31 08:00:00&limit=1&page=1",
"headers": {
"x-api-key": "API_KEY",
"Content-type": "application/json"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
Retrieve natural disasters data using the desired place name and time period.
x-api-key
Content-type
Accept-Language
continent
from
to
eventType
page
limit
https://api.ambeedata.com/disasters/history/by-continent?continent=ANT&from=2024-07-01 12:00:00&to=2024-07-31 08:00:00&limit=1&page=1
const http = require("https");
const options = {
"method": "GET",
"hostname": "api.ambeedata.com",
"port": null,
"path": "/disasters/history/by-continent?continent=ANT&from=2024-07-01 12:00:00&to=2024-07-31 08:00:00&limit=1&page=1",
"headers": {
"x-api-key": "API_KEY",
"Content-type": "application/json"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
Retrieve historical natural disasters data using the specific country codes.
x-api-key
Content-type
Accept-Language
from
to
eventType
page
limit
https://api.ambeedata.com/disasters/history/by-country-code?countryCode=IND&from=2024-07-01 12:00:00&to=2024-07-31 08:00:00&limit=1&page=1
const http = require("https");
const options = {
"method": "GET",
"hostname": "api.ambeedata.com",
"port": null,
"path": "/disasters/history/by-country-code?countryCode=IND&from=2024-07-01 12:00:00&to=2024-07-31 08:00:00&limit=1&page=1",
"headers": {
"x-api-key": "API_KEY",
"Content-type": "application/json"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
Retrieve historical natural disaster data using the start date. Historical data is available on demand for a longer time frame. Get in touch
x-api-key
Content-type
Accept-Language
from
eventType
page
limit
https://api.ambeedata.com/disasters/history?from=2024-07-01 15:00:00&page=1&limit=3
const http = require("https");
const options = {
"method": "GET",
"hostname": "api.ambeedata.com",
"port": null,
"path": "/disasters/history?from=2024-07-01 15:00:00&page=1&limit=3",
"headers": {
"x-api-key": "API_KEY",
"Content-type": "application/json"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
Ambee's Natural Disaster API provides detailed information on various types of natural disasters. Find the full list of the latest and historical disaster events covered based on event_id refer to the List of supported events section.
Provides detailed information about a disaster event based on the event ID returned in any of the latest or historical APIs.
x-api-key
Content-type
Accept-Language
eventId
geometry
https://api.ambeedata.com/disasters/by-eventId?eventId=66860a11a53090009d54d789
const http = require("https");
const options = {
"method": "GET",
"hostname": "api.ambeedata.com",
"port": null,
"path": "/disasters/by-eventId?eventId=66860a11a53090009d54d789",
"headers": {
"x-api-key": "API_KEY",
"Content-type": "application/json"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
Ambee's Natural Disaster API provides detailed information on various types of natural disasters. Refer to the List of supported events section to find the full list of the latest and historical disaster events covered based on source-eventId.
Provides detailed information about a disaster event based on the source event ID returned in any of the latest or historical APIs.
x-api-key
Content-type
Accept-Language
eventId
geometry
https://api.ambeedata.com/disasters/latest/by-source-eventId?sourceEventId=678a11b1f15456e007a91756
const http = require("https");
const options = {
"method": "GET",
"hostname": "api.ambeedata.com",
"port": null,
"path": "/disasters/latest/by-source-eventId?sourceEventId=678a11b1f15456e007a91756",
"headers": {
"x-api-key": "API_KEY",
"Content-type": "application/json"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
Provides detailed information about a disaster event based on the source event ID returned in any of the latest or historical APIs.
x-api-key
Content-type
Accept-Language
eventId
geometry
https://api.ambeedata.com/disasters/history/by-source-eventId?sourceEventId=676102a5fea25dea28c0e89f
const http = require("https");
const options = {
"method": "GET",
"hostname": "api.ambeedata.com",
"port": null,
"path": "/disasters/history/by-source-eventId?sourceEventId=676102a5fea25dea28c0e89f",
"headers": {
"x-api-key": "API_KEY",
"Content-type": "application/json"
}
};
const req = http.request(options, function (res) {
const chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function () {
const body = Buffer.concat(chunks);
console.log(body.toString());
});
});
req.end();
Next
Playground
Yes
No