Beta Plan Free · sin tarjeta

Datos sísmicos oficiales, listos para tu código.

Una sola API para el historial normalizado de siete agencias, la red de estaciones abiertas y webhooks firmados. Claves revocables, cuotas claras y la fuente citada en cada evento.

  • AutenticaciónClave API · OAuth 2.0
  • FormatoJSON sobre HTTPS
  • FuentesSGC, USGS y 5 más
GET /v1/events/history 200 OK
# Solicitud
curl "https://api.seismik.org/v1/events/history?days=7&minimum_magnitude=4" \
  -H "X-Seismik-API-Key: sk_live_…"

# Respuesta (ejemplo)
{
  "events": [{
    "event_id": "sgc_colombia:SGC2026abcxyz",
    "origin_time": "2026-09-17T01:12:47Z",
    "magnitude": 4.6,
    "magnitude_type": "Mw",
    "depth_km": 142.0,
    "place": "Los Santos, Santander",
    "agency": "Servicio Geológico Colombiano",
    "review_status": "reviewed",
    "official_url": "https://www.sgc.gov.co/…"
  }],
  "errors": [],
  "cached": false
}

Productos

Empieza con lo esencial.

Cada producto es un permiso de la clave: das sólo el acceso que tu integración necesita.

Eventos sísmicos

Historial oficial consolidado con magnitud, profundidad, epicentro, agencia, estado de revisión y enlace a la fuente.

events:read

Red de estaciones

Metadatos geográficos de las estaciones sismológicas abiertas y el proveedor SeedLink de cada una.

stations:read

Webhooks institucionales

Eventos preliminares u oficiales, firmados con HMAC y entregados desde una cola durable, para simulacros e investigación.

simulation_only

Documentación

Tu primera solicitud en tres pasos.

  1. 1

    Crea una clave

    Entra con tu cuenta, elige los permisos y guarda la clave: sólo se muestra una vez.

  2. 2

    Envía el encabezado

    Cada solicitud lleva X-Seismik-API-Key. Nunca la pongas en una app pública ni en el navegador.

  3. 3

    Cita la fuente

    Cada evento trae agency y official_url. Muéstralos: Seismik agrega, la agencia informa.

Endpoints

GET/v1/public/showcase-eventsAlways Free · sin clave

Los últimos sismos oficiales de magnitud considerable (M ≥ 4.5 fija). Es lo que muestra el panel en vivo de seismik.org: pruébala sin crear cuenta.

limit
1–20 · 6 por defecto
format
json (por defecto) o geojson
Sin encabezado. Límite: 30 solicitudes/min por IP.
GET/v1/events/history

Historial oficial consolidado y filtrable.

days
1–30 · 7 por defecto
minimum_magnitude
0–10 · 2.5 por defecto
limit
1–500 · 200 por defecto
sources
sgc_colombia,usgs_global…
format
json (por defecto) o geojson
Requiere events:read
GET/v1/events/recent

Eventos oficiales recientes, de baja latencia.

format
json (por defecto) o geojson
Requiere events:read
GET/v1/network/stations

Catálogo geográfico de estaciones abiertas.

format
json (por defecto) o geojson
Requiere stations:read

Pruébalo

cURL
curl "https://api.seismik.org/v1/events/history?days=7&minimum_magnitude=4" \
  -H "X-Seismik-API-Key: sk_test_TU_CLAVE"

GeoJSON

Los cuatro endpoints de datos devuelven una FeatureCollection (RFC 7946) con format=geojson, lista para QGIS, Leaflet, Mapbox o geopandas. El cupo y los permisos son los mismos que con JSON.

cURL
curl "https://api.seismik.org/v1/events/history?days=7&minimum_magnitude=4&format=geojson" \
  -H "X-Seismik-API-Key: sk_test_TU_CLAVE"
Respuesta · application/geo+json
{
  "type": "FeatureCollection",
  "features": [{
    "type": "Feature",
    "id": "usgs_global:us7000abcd",
    "geometry": { "type": "Point", "coordinates": [-73.12, 6.72] },
    "properties": {
      "magnitude": 5.1, "magnitude_type": "mww", "depth_km": 142.0,
      "origin_time": "2026-09-20T01:12:47+00:00",
      "place": "Los Santos, Santander", "agency": "USGS"
    }
  }],
  "metadata": { "sources": [...], "errors": [], "cached": false, "generated_at": "..." }
}
Coordenadas
[longitud, latitud] en WGS 84, siempre dos valores.
Profundidad
En properties.depth_km. No va como tercera coordenada: en RFC 7946 sería altitud.
Sin ubicación
El evento no se omite: sale con "geometry": null.
Campos
Los mismos que en JSON, sin latitude ni longitude. id es el event_id (o el station_id).
Metadatos
Fuentes, errors parciales y caché, en el miembro metadata de la colección.
Tipo
Content-Type: application/geo+json. Otro valor de format responde 422.
Python · geopandas
import geopandas as gpd, requests

r = requests.get("https://api.seismik.org/v1/events/history",
                 params={"days": 7, "format": "geojson"},
                 headers={"X-Seismik-API-Key": "sk_test_TU_CLAVE"})
sismos = gpd.GeoDataFrame.from_features(r.json()["features"], crs="EPSG:4326")

Errores

Los errores HTTP controlados y de parámetros de la API incluyen detail y code: una cadena estable para que tu código decida qué hacer. Las respuestas de Cloudflare, del proxy o de fallos no controlados pueden tener otro formato; comprueba también el estado HTTP.

HTTP 429
{ "detail": "Daily API quota exceeded", "code": "quota_daily" }
Retry-After: 86400
400bad_request Solicitud mal formada.
401api_key_missing_or_invalid Falta el encabezado X-Seismik-API-Key o la clave no tiene el formato esperado.
401api_key_invalid La clave no existe, fue revocada o rotada.
401unauthorized Credencial ausente o inválida en rutas que no usan clave (sesión de dispositivo o de cuenta).
403scope_insufficient La clave no tiene el permiso del endpoint (events:read o stations:read).
403forbidden No tienes permiso para esa acción.
404not_found La ruta o el recurso no existe.
422invalid_parameter Un parámetro está fuera de rango o no es válido (por ejemplo format=kml o days=99). detail lista cuáles.
429rate_limit_minute Superaste las solicitudes por minuto de tu plan. Retry-After: 60.
429quota_daily Superaste las solicitudes del día (UTC). Retry-After: 86400.
429quota_monthly Agotaste el cupo mensual. Retry-After son los segundos hasta el día 1.
429rate_limit_ip Sólo la Always Free API: 30 solicitudes por minuto por IP. Retry-After: 60.
429too_many_requests Otro límite de frecuencia; respeta Retry-After.
500internal_error Falló algo de nuestro lado. Reintenta con espera creciente; si persiste, escríbenos.
503station_catalog_unavailable El catálogo de estaciones no está disponible por ahora. Reintenta.
503usage_meter_busy El contador de uso estaba ocupado. Reintenta tras Retry-After: 1.
503service_unavailable Servicio no disponible temporalmente. Reintenta.
504gateway_timeout La solicitud tardó demasiado. Reintenta o reduce limit y days.

Un 200 también puede traer fallos parciales: en /v1/events/history, si una fuente no responde, el resto de los eventos llega igual y la fuente aparece en errors (en GeoJSON, en metadata.errors).

La API informa la agencia y el enlace oficial de cada evento. Seismik agrega y normaliza; no sustituye a las entidades sismológicas.

Seismik Always Free API

La puerta de entrada: sin clave, sin registro, siempre gratis.

Un único endpoint, pensado para probar la API o para un widget público de bajo tráfico. No es una versión recortada del plan free con clave: es otra cosa, con otro contrato.

Llámala así

cURL
curl "https://seismik.org/v1/public/showcase-events?limit=6"

Sin encabezado de autenticación. Funciona igual desde api.seismik.org o desde seismik.org: el segundo es la misma API detrás del sitio.

Qué trae

  • Sismos confirmados por una agencia oficial (USGS, EMSC/CSEM y las demás fuentes disponibles).
  • Sólo magnitud 4.5 o mayor: lo que de verdad importa mostrar sin contexto adicional.
  • event_id, origin_time, coordenadas, magnitude, magnitude_type, depth_km, agency, place y official_url — los mismos campos del ejemplo autenticado.
  • Hasta 20 eventos por solicitud con limit.

Qué no trae

  • Eventos preliminares o candidatos sin confirmar: para eso, events:read con una clave.
  • Filtros por fecha, fuente o una magnitud mínima distinta a 4.5 — eso es /v1/events/history.
  • Estaciones ni webhooks: fuera del alcance de este endpoint.
  • Cuota por cuenta: el límite es compartido, por IP, 30 solicitudes por minuto.

Planes de la API

Desde tu primera clave hasta una integración empresarial.

Elige una mensualidad fija: Pro US$19, Max US$49 o Ultra US$129, o paga por uso con Pay-as-you-go desde US$5 de saldo. Always Free permite empezar gratis y Enterprise se negocia. Precios en dólares estadounidenses antes de los impuestos aplicables. Durante la beta no se cobra ni se piden tarjetas.

Inicia sesión para guardar tu selección. No se activa ni cobra un plan al elegirlo.

Contactar para activar mi plan

El endpoint público sin clave es independiente de estos planes. Ningún plan garantiza predicción sísmica, certificación de seguridad o un SLA no contratado.

Cada límite, a la vista

Compara lo que incluye cada plan.

Todos incluyen acceso a eventos recientes, historial de hasta 30 días y catálogo de estaciones mediante claves con alcances, rotación y revocación. Elige según tu volumen y tu forma de pago.

En pantallas pequeñas, desliza la tabla para ver todos los planes.

Paquetes de saldo para Pay-as-you-go

Costo por solicitud

Precios de lista de la API

Los precios por consulta corresponden sólo a Pay-as-you-go y se aplicarán tras activar expresamente el cobro. Pro, Max y Ultra incluyen las consultas dentro de sus cuotas, sin cargo adicional automático; al alcanzar el límite la API rechaza solicitudes hasta el reinicio de la cuota correspondiente. Todos los planes tienen límites por minuto, día y mes, compartidos entre las claves de la cuenta. Always Free no descuenta saldo ni genera cargos. Enterprise se contrata por acuerdo. Los límites diarios se reinician a las 00:00 UTC y los mensuales el día 1 a las 00:00 UTC; las consultas no utilizadas no se acumulan. El pago por uso tiene un límite operativo de 1.000.000 consultas/mes; un mayor volumen requiere un acuerdo. No incluye SLA garantizado, archivo histórico permanente ni servicios de emergencia.

Tu cuenta

Claves, cuotas y webhooks.

Inicia sesión con una cuenta verificada para administrar tus credenciales.

Clave creada

Guárdala ahora.

Por seguridad no podremos volver a mostrarla.

Webhook creado

Guarda el secreto de firma.

Se muestra sólo una vez; tu servidor lo necesita para validar cada entrega.

Acción sensible

Confirma la acción