Earthquake records from around the world collected from the United States Geological Survey. Important details about the earthquake such as distance, gap, magnitude, depth and significance are included to properly describe the earthquake. Additionally, data about exact geological coordinates and a relative description of the earthquake's location is included. The earthquakes collected are from the past month.


Explore Structure

Index Type Example Value
0 dict { }
... ... ...
Key Type Example Value Comment
"magnitude" float 1.43 Earthquake magnitude is a measure of the size of an earthquake at its source. It is a logarithmic measure. At the same distance from the earthquake, the amplitude of the seismic waves from which the magnitude is determined are approximately 10 times as large during a magnitude 5 earthquake as during a magnitude 4 earthquake. The total amount of energy released by the earthquake usually goes up by a larger factor; for many commonly used magnitude types, the total energy of an average earthquake goes up by a factor of approximately 32 for each unit increase in magnitude. Typically ranges from -1 (very tiny) to 10 (incredibly powerful).
"significance" int 31 A number describing how significant the event is. Larger numbers indicate a more significant event. This value is determined on a number of factors, including magnitude, maximum MMI, felt reports, and estimated impact. Ranges from 0 to 1000.
"gap" float 122.0 In general, the smaller this number, the more reliable is the calculated horizontal position of the earthquake. Specifically, this means the largest azimuthal gap between azimuthally adjacent stations (in degrees). Earthquake locations in which the azimuthal gap exceeds 180 degrees typically have large location and depth uncertainties. Ranges from 0 to 180.
Key Type Example Value Comment
"distance" float 0.1034 The rough distance that this earthquake occurred away from the reporting station, measured in degrees between. 1 degree is approximately 111.2 kilometers. In general, the smaller this number, the more reliable is the calculated depth of the earthquake. In general, this number is between 0.4-7.1.
"full" str "13km E of Livermore, California"
"name" str "California" A best guess for the name of the state (or country, in some cases) that this earthquake was reported in.
"longitude" float -121.619 Decimal degrees longitude (east and west on the globe). Negative values for western latitudes. Ranges from -180 to 180.
"depth" float 15.12 Depth of the event in kilometers.
"latitude" float 37.6723333 Decimal degrees latitude (up and down on the globe). Negative values for southern latitudes. Ranges from -90 to 90.
Key Type Example Value Comment
"impact" dict { }
"id" str "nc72666881" A unique name for this earthquake.
"location" dict { }
"time" dict { }
Key Type Example Value Comment
"full" str "2016-07-27 00:19:43"
"hour" int 0
"second" int 43
"month" int 7
"epoch" long 1469593183550 A number that represents the time that this earthquake occurred. Epoch's are the number of seconds since a particular date (January 1st, 1970), and are a convenient way to store date/times.
"year" int 2016
"day" int 27
"minute" int 19


Download all of the following files.


This library has 1 function you can use.
import earthquakes
list_of_earthquake = earthquakes.get_earthquakes()



Returns earthquakes from the dataset.