{"openapi":"3.1.0","info":{"title":"SeismoAtlas public API","version":"1.0.0","description":"Fused real-time earthquake catalogue: one event per earthquake, with every agency's solution. Free, no key. Rate limit: bursts of 120 requests, then 2 per second per IP (HTTP 429 with Retry-After beyond that). Responses are cached for 30 s. Every response carries an \"attribution\" block; keep it when you republish (USGS public domain; GFZ, INGV CC BY 4.0; JMA 出典：気象庁; EMSC and AFAD only where permitted). Not an official warning service.","contact":{"url":"https://seismoatlas.com/developers","email":"hello@seismoatlas.com"},"license":{"name":"Data licences per source; see attribution","url":"https://seismoatlas.com/data-sources"}},"servers":[{"url":"https://seismoatlas.com"}],"paths":{"/api/v1/events":{"get":{"summary":"Latest fused events","operationId":"listEvents","parameters":[{"name":"range","in":"query","required":false,"description":"24h (all magnitudes), 7d (M2.5+), 30d (M4+)","schema":{"type":"string","enum":["24h","7d","30d"],"default":"24h"}},{"name":"since","in":"query","required":false,"description":"Start, ISO 8601 or ms (overrides range floor)","schema":{"type":"string"}},{"name":"until","in":"query","required":false,"description":"End, ISO 8601 or ms","schema":{"type":"string"}},{"name":"minmag","in":"query","required":false,"description":"Minimum magnitude","schema":{"type":"number"}},{"name":"maxmag","in":"query","required":false,"description":"Maximum magnitude","schema":{"type":"number"}},{"name":"cc","in":"query","required":false,"description":"Country, ISO 3166-1 alpha-2","schema":{"type":"string"}},{"name":"bbox","in":"query","required":false,"description":"west,south,east,north","schema":{"type":"string"}},{"name":"near","in":"query","required":false,"description":"lat,lon,km (km ≤ 2000)","schema":{"type":"string"}},{"name":"order","in":"query","required":false,"description":"time or mag","schema":{"type":"string","enum":["time","mag"]}},{"name":"limit","in":"query","required":false,"description":"≤ 5000","schema":{"type":"integer"}},{"name":"format","in":"query","required":false,"description":"json (compact) or geojson","schema":{"type":"string","enum":["json","geojson"]}}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Remaining":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"generated":{"type":"integer"},"updated":{"type":"integer"},"count":{"type":"integer"},"attribution":{"type":"object","description":"Source credits that must accompany reused data.","properties":{"publisher":{"type":"string"},"note":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"licence":{"type":"string"},"credit":{"type":"string"},"url":{"type":"string"}}}}}},"events":{"type":"array","items":{"$ref":"#/components/schemas/QuakeLite"}}}}}}},"400":{"description":"Invalid parameters"},"429":{"description":"Rate limited; see Retry-After"}}}},"/api/v1/events/{id}":{"get":{"summary":"One event with all solutions, nearby cities and aftershocks","operationId":"getEvent","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"SeismoAtlas id or any provider alias (e.g. usgs:us6000abcd)"}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Remaining":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown event"},"429":{"description":"Rate limited; see Retry-After"}}}},"/api/v1/near":{"get":{"summary":"Events near a point, nearest first","operationId":"near","parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude","schema":{"type":"number"}},{"name":"lon","in":"query","required":true,"description":"Longitude","schema":{"type":"number"}},{"name":"km","in":"query","required":false,"description":"Radius km (≤ 1000, default 100)","schema":{"type":"number"}},{"name":"days","in":"query","required":false,"description":"Look-back days (≤ 30, default 7)","schema":{"type":"number"}},{"name":"minmag","in":"query","required":false,"description":"Minimum magnitude","schema":{"type":"number"}}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Remaining":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"attribution":{"type":"object","description":"Source credits that must accompany reused data.","properties":{"publisher":{"type":"string"},"note":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"licence":{"type":"string"},"credit":{"type":"string"},"url":{"type":"string"}}}}}},"events":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/QuakeLite"},{"type":"object","properties":{"km":{"type":"number"}}}]}}}}}}},"400":{"description":"Invalid parameters"},"429":{"description":"Rate limited; see Retry-After"}}}},"/api/v1/regions":{"get":{"summary":"Countries with region pages and their 30-day counts","operationId":"listRegions","responses":{"200":{"description":"OK","headers":{"RateLimit-Remaining":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/regions/{cc}":{"get":{"summary":"30-day summary for a country","operationId":"regionSummary","parameters":[{"name":"cc","in":"path","required":true,"schema":{"type":"string"},"description":"ISO 3166-1 alpha-2 code or region slug"}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Remaining":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"day":{"type":"integer"},"week":{"type":"integer"},"largest":{"$ref":"#/components/schemas/QuakeLite"},"bands":{"type":"array","items":{"type":"integer"},"description":"Counts for <2, 2–2.9, 3–3.9, 4–4.9, 5–5.9, 6+"},"depth":{"type":"array","items":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"},"n":{"type":"integer"}}}},"daily":{"type":"array","items":{"type":"integer"},"description":"Events per day, oldest first (30 values)"},"latest":{"type":"array","items":{"$ref":"#/components/schemas/QuakeLite"}}}}}}},"404":{"description":"Unknown region"}}}},"/api/v1/history":{"get":{"summary":"Historical search (USGS ComCat, 1900–today)","operationId":"history","parameters":[{"name":"start","in":"query","required":true,"description":"YYYY-MM-DD","schema":{"type":"string"}},{"name":"end","in":"query","required":true,"description":"YYYY-MM-DD","schema":{"type":"string"}},{"name":"minmag","in":"query","required":false,"description":"Minimum magnitude","schema":{"type":"number"}},{"name":"bbox","in":"query","required":false,"description":"west,south,east,north","schema":{"type":"string"}},{"name":"cc","in":"query","required":false,"description":"Country code (bounding box of the country)","schema":{"type":"string"}},{"name":"near","in":"query","required":false,"description":"lat,lon,km","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","headers":{"RateLimit-Remaining":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameters"},"429":{"description":"Rate limited; see Retry-After"}}}},"/api/stream":{"get":{"summary":"Live Server-Sent Events","description":"Events: \"hello\" on connect, then \"quake\" with {type: \"created\"|\"updated\", e: QuakeLite}. Comment pings every 15 s.","operationId":"stream","responses":{"200":{"description":"text/event-stream","content":{"text/event-stream":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"QuakeLite":{"type":"object","description":"Compact fused event.","required":["id","t","lat","lon","d","m","title","place","slug","st","ag","u"],"properties":{"id":{"type":"string","description":"Stable SeismoAtlas id (no hyphens). Event page: /earthquake/{id}-{slug}"},"t":{"type":"integer","description":"Origin time, ms since epoch (UTC)"},"lat":{"type":"number"},"lon":{"type":"number"},"d":{"type":"number","description":"Depth, km"},"m":{"type":["number","null"],"description":"Headline magnitude"},"mt":{"type":"string","description":"Magnitude type (Mww, mb, ML …)"},"title":{"type":"string","example":"M5.2 earthquake 12 km NE of İzmir, Türkiye"},"place":{"type":"string"},"cc":{"type":["string","null"],"description":"ISO 3166-1 alpha-2 of the nearest country within 200 km"},"slug":{"type":"string"},"st":{"type":"string","enum":["r","a"],"description":"r = headline solution reviewed, a = automatic or not stated"},"rev":{"type":"boolean","description":"Magnitude revised since first publication"},"m0":{"type":["number","null"],"description":"First published magnitude (when revised)"},"ag":{"type":"array","description":"Every agency solution","items":{"type":"object","properties":{"p":{"type":"string","enum":["usgs","emsc","geofon","ingv","jma","afad"]},"a":{"type":"string","description":"Authoring network/agency"},"m":{"type":["number","null"]},"mt":{"type":"string"},"st":{"type":"string","enum":["r","a"]}}}},"ts":{"type":"boolean","description":"USGS tsunami flag (not a warning)"},"f":{"type":"integer","description":"Felt reports received"},"k":{"type":"string","description":"Event type when not an earthquake"},"u":{"type":"integer","description":"Last update, ms"}}},"Attribution":{"type":"object","description":"Source credits that must accompany reused data.","properties":{"publisher":{"type":"string"},"note":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"licence":{"type":"string"},"credit":{"type":"string"},"url":{"type":"string"}}}}}},"Summary":{"type":"object","properties":{"total":{"type":"integer"},"day":{"type":"integer"},"week":{"type":"integer"},"largest":{"$ref":"#/components/schemas/QuakeLite"},"bands":{"type":"array","items":{"type":"integer"},"description":"Counts for <2, 2–2.9, 3–3.9, 4–4.9, 5–5.9, 6+"},"depth":{"type":"array","items":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"},"n":{"type":"integer"}}}},"daily":{"type":"array","items":{"type":"integer"},"description":"Events per day, oldest first (30 values)"},"latest":{"type":"array","items":{"$ref":"#/components/schemas/QuakeLite"}}}}}},"x-mcp":{"url":"https://seismoatlas.com/mcp","transport":"streamable-http"}}