/api/hazard/earthquake/1 créditoTerremotos
Un proxy transparente del servicio de eventos sísmicos FDSN del Servicio Geológico de los Estados Unidos (USGS). Es un conjunto de datos sismológicos históricos y casi en tiempo real, no un cálculo astrológico; se incluye para que, en astrología mundana y en estudios de correlación de eventos, puedas obtener los eventos y los datos de la carta con una sola API. Todos los parámetros de consulta se reenvían sin cambios a USGS, así que se aplica todo el vocabulario FDSN: `starttime` y `endtime` en ISO 8601 (por defecto, los últimos treinta días), un rectángulo delimitador mediante `minlatitude`/`maxlatitude`/`minlongitude`/`maxlongitude` o un círculo mediante `latitude`/`longitude` con `maxradius` o `maxradiuskm`, `minmagnitude`/`maxmagnitude`, `mindepth`/`maxdepth`, `minsig`/`maxsig`, el `alertlevel` de PAGER, `eventtype`, `reviewstatus`, `limit` hasta 20000, `offset` y `orderby`. La respuesta es la FeatureCollection GeoJSON de USGS, tal cual la devuelve el servicio: un objeto `metadata` con el `count` de resultados y una lista `features` en la que cada entrada tiene una `geometry` con [longitud, latitud, profundidad en km] y un objeto `properties` con la magnitud, la descripción del lugar, el `time` en milisegundos de época, los informes de percepción, las intensidades de Mercalli y Community, la significancia, un indicador de tsunami y la URL de la página del evento en USGS. El parámetro `format` se ignora: siempre se usa geojson. Si no se puede contactar con USGS, el endpoint devuelve 503.
https://api.occultapi.com/api/hazard/earthquake/Autenticación
Envía tu clave en la cabecera X-API-Key. La clave es una credencial de servidor: nunca la pongas en el JavaScript del navegador ni en una app móvil.
X-API-Key: yt_live_a1b2c3d4_…Parámetros de consulta (42)
Van en la URL. Son opcionales salvo que se indique lo contrario y se pueden combinar: primero se filtra, luego se pagina y al final se ordena.
| Parámetro | Tipo | Ejemplo | Para qué sirve | |
|---|---|---|---|---|
| alertlevel | string | green | Limitar a eventos con un nivel de alerta PAGER concretouno de: green, orange, red, yellow | |
| catalog | string | — | Limitar a eventos de un catálogo concreto | |
| contributor | string | — | Limitar a eventos aportados por un colaborador concreto | |
| endtime | string | 2024-12-31 | Fin del intervalo de tiempo (ISO8601). Por defecto: la hora actual Fecha ISO, o fecha con hora. Se incluye en el intervalo. | |
| eventid | string | — | Seleccionar un evento concreto por ID (implica includeallorigins e includeallmagnitudes) ID de evento de USGS en FORMATO LIBRE (p. ej., 'us7000abcd'). Seleccionar uno implica includeallorigins e includeallmagnitudes. Se reenvía tal cual. | |
| eventtype | string | — | Limitar a eventos de un tipo concreto (p. ej., 'earthquake' filtra los eventos que no son terremotos) | |
| includeallmagnitudes | boolean | — | Incluir todas las magnitudes de cada evento (por defecto: false) | |
| includeallorigins | boolean | — | Incluir todos los orígenes de cada evento (por defecto: false) | |
| includearrivals | boolean | — | Incluir las llegadas de fase (por defecto: false, NO IMPLEMENTADO ACTUALMENTE) | |
| includedeleted | string | — | Incluir los eventos eliminados (por defecto: false). Usa 'only' para devolver solo los eventos eliminados La propia descripción del parámetro en el endpoint lo documenta como booleano más 'only' («Include deleted events (default: false). Use 'only' to return only deleted events»). No hay comprobación local: el valor se reenvía a USGS, que es quien lo valida. uno de: true, false, only | |
| includesuperseded | boolean | — | Incluir los productos sustituidos (por defecto: false). Solo funciona con eventid | |
| latitude | number | 26.9124 | Latitud del centro para la búsqueda circular [-90, 90]. Requiere longitude y maxradius/maxradiuskm Centro de una búsqueda circular, que se usa con longitude y maxradiuskm. | |
| limit | integer | 20 | Número máximo de eventos que devolver [1, 20000] Cuántos registros devolver por página. | |
| longitude | number | 75.7873 | Longitud del centro para la búsqueda circular [-180, 180] | |
| maxalertlevel | string | green | Limitar a eventos con un nivel de alerta PAGER ≤ este valoruno de: green, orange, red, yellow | |
| maxcdi | number | — | Intensidad máxima determinada por la comunidad (DYFI) [0, 12] | |
| maxdepth | number | — | Profundidad máxima en km [-100, 1000] | |
| maxgap | number | — | Brecha azimutal máxima en grados [0, 360] | |
| maxlatitude | number | — | Límite norte del rectángulo delimitador [-90, 90] | |
| maxlongitude | number | — | Límite este del rectángulo delimitador [-360, 360] | |
| maxmagnitude | number | 9 | Magnitud máxima | |
| maxmmi | number | — | Intensidad máxima en la escala de Mercalli modificada (ShakeMap) [0, 12] | |
| maxradius | number | — | Radio máximo en grados desde el punto central [0, 180]. Incompatible con maxradiuskm | |
| maxradiuskm | number | 500 | Radio máximo en km desde el punto central [0, 20001.6]. Incompatible con maxradius Radio de búsqueda en kilómetros alrededor de latitude/longitude. | |
| maxsig | integer | — | Significancia máxima | |
| minalertlevel | string | green | Limitar a eventos con un nivel de alerta PAGER ≥ este valoruno de: green, orange, red, yellow | |
| mincdi | number | — | Intensidad mínima determinada por la comunidad (DYFI) | |
| mindepth | number | — | Profundidad mínima en km [-100, 1000] | |
| minfelt | integer | — | Número mínimo de respuestas DYFI [1, ∞] | |
| mingap | number | — | Brecha azimutal mínima en grados [0, 360] | |
| minlatitude | number | — | Límite sur del rectángulo delimitador [-90, 90] | |
| minlongitude | number | — | Límite oeste del rectángulo delimitador [-360, 360]. Los rectángulos pueden cruzar la línea de cambio de fecha usando minlongitude < -180 o maxlongitude > 180 | |
| minmagnitude | number | 6 | Magnitud mínima Magnitud mínima en la escala de Richter. A partir de 6 es un terremoto importante. | |
| minsig | integer | — | Significancia mínima | |
| nodata | integer | 204 | Código de estado HTTP que se devuelve cuando no se encuentran datos (204 o 404)uno de: 204, 404 | |
| offset | integer | 0 | Devolver los resultados a partir de esta posición (con base 1) Cuántos registros omitir, para la paginación. | |
| orderby | string | magnitude | Ordenar los resultados por campouno de: magnitude, magnitude-asc, time, time-asc | |
| productcode | string | — | Devolver el evento asociado a este código de producto Código de producto de USGS en FORMATO LIBRE. Se reenvía tal cual. | |
| producttype | string | — | Limitar a eventos con este tipo de producto (p. ej., moment-tensor, focal-mechanism, shakemap, losspager, dyfi) | |
| reviewstatus | string | automatic | Limitar a eventos con un estado de revisión concretouno de: automatic, reviewed | |
| starttime | string | 2024-01-01 | Inicio del intervalo de tiempo (ISO8601, p. ej., 2022-01-01 o 2022-01-01T00:00:00). Por defecto: AHORA - 30 días Fecha ISO, o fecha con hora. Se incluye en el intervalo. | |
| updatedafter | string | — | Limitar a eventos actualizados después de este momento (ISO8601) Restricción de FORMATO. ISO 8601. Se reenvía tal cual a USGS. |
Ejemplo de solicitud
curl "https://api.occultapi.com/api/hazard/earthquake/" \
-H "X-API-Key: $OCCULT_API_KEY"Respuesta
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"type\": \"FeatureCollection\", \"metadata\": {\"generated\": 1788775941000, \"url\": \"https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson\", \"title\": \"USGS Earthquakes\", \"status\": 200, \"api\": \"2.7.0\", \"count\": 10949}, \"features\": [{\"type\": \"Feature\", \"properties\": {\"mag\": 1.3, \"place\": \"78 km WNW of Tyonek, Alaska\", \"time\": 1788775260489, \"updated\": 1788775310002, \"tz\": null, \"url\": \"https://earthquake.usgs.gov/earthquakes/eventpage/aka2026rsrmqf\", \"detail\": \"https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=aka2026rsrmqf&format=geojson\", \"felt\": null, \"cdi\": null, \"mmi\": null, \"alert\": null, \"status\": \"automatic\", \"tsunami\": 0, \"sig\": 26, \"net\": \"ak\", \"code\": \"a2026rsrmqf\", \"ids\": \",aka2026rsrmqf,\", \"sources\": \",ak,\", \"types\": \",origin,phase-data,\", \"nst\": 17, \"dmin\": 0, \"rms\": 0.3, \"gap\": 92, \"magType\": \"ml\", \"type\": \"earthquake\", \"title\": \"M 1.3 - 78 km WNW of Tyonek, Alaska\"}, \"geometry\": {\"type\": \"Point\", \"coordinates\": [-152.516, 61.307, 4.2]}, \"id\": \"aka2026rsrmqf\"}, {\"type\": \"Feature\", \"properties\": {\"mag\": 2.2, \"place\": \"36 km W of Happy Valley, Alaska\", \"time\": 1788774950719, \"updated\": 1788775176753, \"tz\": null, \"url\": \"https://earthquake.usgs.gov/earthquakes/eventpage/aka2026rsridv\", \"detail\": \"https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=aka2026rsridv&format=geojson\", \"felt\": null, \"cdi\": null, \"mmi\": null, \"alert\": null, \"status\": \"automatic\", \"tsunami\": 0, \"sig\": 74, \"net\": \"ak\", \"code\": \"a2026rsridv\", \"ids\": \",aka2026rsridv,\", \"sources\": \",ak,\", \"types\": \",origin,phase-data,\", \"nst\": 68, \"dmin\": 0.3, \"rms\": 0.6, \"gap\": 53, \"magType\": \"ml\", \"type\": \"earthquake\", \"title\": \"M 2.2 - 36 km W of Happy Valley, Alaska\"}, \"geometry\": {\"type\": \"Point\", \"coordinates\": [-152.39, 59.98, 79.6]}, \"id\": \"aka2026rsridv\"}, {\"type\": \"Feature\", \"properties\": {\"mag\": 1.7, \"place\": \"28 km NNW of Pāhala, Hawaii\", \"time\": 1788774479410, \"updated\": 1788774689400, \"tz\": null, \"url\": \"https://earthquake.usgs.gov/earthquakes/eventpage/hv75030377\", \"detail\": \"https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=hv75030377&format=geojson\", \"felt\": null, \"cdi\": null, \"mmi\": null, \"alert\": null, \"status\": \"automatic\", \"tsunami\": 0, \"sig\": 44, \"net\": \"hv\", \"code\": \"75030377\", \"ids\": \",hv75030377,\", \"sources\": \",hv,\", \"types\": \",origin,phase-data,\", \"nst\": 17, \"dmin\": 0.0364, \"rms\": 0.200000003, \"gap\": 68, \"magType\": \"md\", \"type\": \"earthquake\", \"title\": \"M 1.7 - 28 km NNW of Pāhala, Hawaii\"}, \"geometry\": {\"type\": \"Point\", \"coordinates\": [-155.594665527344, 19.4323329925537, 37.8300018310547]}, \"id\": \"hv75030377\"}, {\"type\": \"Feature\", \"properties\": {\"mag\": 0.7, \"place\": \"6 km WNW of Cobb, CA\", \"time\": 1788774330340, \"updated\": 1788775642619, \"tz\": null, \"url\": \"https://earthquake.usgs.gov/earthquakes/eventpage/nc75431077\", \"detail\": \"https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=nc75431077&format=geojson\", \"felt\": null, \"cdi\": null, \"mmi\": null, \"alert\": null, \"status\": \"automatic\", \"tsunami\": 0, \"sig\": 8, \"net\": \"nc\", \"code\": \"75431077\", \"ids\": \",nc75431077,\", \"sources\": \",nc,\", \"types\": \",nearby-cities,origin,phase-data,scitech-link,\", \"nst\": 8, \"dmin\": 0.002696, \"rms\": 0.01, \"gap\": 122, \"magType\": \"md\", \"type\": \"earthquake\", \"title\": \"M 0.7 - 6 km WNW of Cobb, CA\"}, \"geometry\": {\"type\": \"Point\", \"coordinates\": [-122.793663024902, 38.8376655578613, 1.87999999523163]}, \"id\": \"nc75431077\"}, {\"type\": \"Feature\", \"properties\": {\"mag\": 1.5, \"place\": \"29 km W of Toyah, Texas\", \"time\": 1788773169470, \"updated\": 1788773302767, \"tz\": null, \"url\": \"https://earthquake.usgs.gov/earthquakes/eventpage/tx2026rpuovc\", \"detail\": \"https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=tx2026rpuovc&format=geojson\", \"felt\": null, \"cdi\": null, \"mmi\": null, \"alert\": null, \"status\": \"automatic\", \"tsunami\": 0, \"sig\": 35, \"net\": \"tx\", \"code\": \"2026rpuovc\", \"ids\": \",tx2026rpuovc,\", \"sources\": \",tx,\", \"types\": \",origin,phase-data,\", \"nst\": 5, \"dmin\": 0.2, \"rms\": 1.2, \"gap\": 215, \"magType\": \"ml\", \"type\": \"earthquake\", \"title\": \"M 1."
}Obtenida de una llamada real con la solicitud de arriba, tal cual. Los resultados van dentro de data.
Errores
Los errores de control de uso devuelven { "error": "…", "message": "<code>", "is_error": true }. Muestra error al usuario y usa message para decidir qué hace tu código. Consulta la referencia de errores.