자료 창구(API)

관측기관이 내놓은 그대로의 기록을 JSON 으로 드립니다. 지진·화산·해일·홍수·산불·소행성·감염병·무력충돌 여덟 갈래입니다.

뉴스는 나가지 않습니다. 저희는 화면에 언론사 기사도 함께 모으지만, 이 창구로는 관측기관에서 온 기록만 나갑니다. 남의 기사를 돈 받고 다시 파는 자리가 아니기 때문입니다.

관측기관이라고 다 나가는 것도 아닙니다. 이용 조건을 직접 읽어 재배포·상업적 이용이 되는 것으로 확인한 열한 곳만 나갑니다. 예를 들어 세계보건기구(WHO)와 범미보건기구(PAHO) 자료는 비상업 조건(CC BY-NC-SA 3.0 IGO) 이라 이 창구로 안 나갑니다 — 화면에서는 보이지만 창구에서는 빠집니다.

열쇠

열쇠는 사람이 직접 드립니다 — 4dmixxai@gmail.com 로 쓰실 곳을 알려 주시면 발급해 드립니다. 자동 가입·자동 결제는 없습니다.

curl -H "Authorization: Bearer dir_xxxxxxxx" \
  "https://disasterir.com/v1/events?topic=earthquake&min_mag=5&limit=20"

GET /v1/events

topic	`earthquake` `volcano` `tsunami` `flood` `wildfire` `asteroid` `conflict` `pandemic`
country	나라 이름(한국어 또는 영문). 예: `Japan`
since	이 시각 뒤의 것만. ISO 8601. 예: `2026-10-01T00:00:00+09:00`
min_mag	지진 규모 하한. 예: `5.0`
limit	1~1000 (기본 100)

{
 "meta": {"as_of": "...", "count": 2, "plan": "pro",
          "used_today": 17, "limit_per_day": 100000,
          "credit": ["Credit: U.S. Geological Survey"],
          "attribution": "..."},
 "data": [
  {"key": "02f9...", "at": "2026-10-01T16:12:44+09:00", "topic": "지진",
   "title": "M 4.9 - 62 km W of Cafayate, Argentina",
   "country": "아르헨티나", "bloc": "미주",
   "lat": -26.057, "lon": -66.607, "exact": true,
   "mag": 4.9, "source": "USGS-지진(규모 4.5+ 한 달)",
   "link": "https://earthquake.usgs.gov/..."}
 ]
}

GET /v1/clock

재난시계 한 값. clock(23:15) · score · level(평온·주의·경계·심각) · window_days.

꼭 보실 것

exact	거짓이면 좌표를 안 드립니다. 그 기록은 정확한 지점이 아니라 나라 단위로만 들어온 것이라, 좌표를 드리면 틀린 지도를 그리게 됩니다.
source	지우지 마세요. 출처 표기가 원 기관의 이용 조건입니다.
meta.credit	이 답에 필요한 출처 표기를 그대로 적어 드립니다. 기관마다 요구하는 문구가 다릅니다(NASA 는 `Courtesy NASA/JPL-Caltech`, GDELT 는 인용과 링크). 받은 줄을 그대로 쓰시면 됩니다 — 저희에게 물어보실 일이 없게 하려고 답마다 붙입니다.
예보 아님	여기 모든 기록은 이미 일어나 관측된 일입니다. 앞일을 점치는 값은 한 개도 없습니다.
갱신	하루 네 번(06:10 · 11:10 · 17:10 · 20:10 KST) 모읍니다. 그 사이에는 같은 값이 나옵니다.

어디서 온 자료인가 · 출처 표기

열한 곳입니다. 가운데 줄이 meta.credit 으로 받으실 문구입니다.

미국 지질조사국(USGS) 지진	`Credit: U.S. Geological Survey` 미국 연방정부 저작물 — 퍼블릭 도메인. 기록의 70%가 여기서 옵니다.
NASA/JPL 소행성 근접통과	`Courtesy NASA/JPL-Caltech` 사전 허락 없이 어떤 용도로든 쓸 수 있습니다. 단 NASA 가 보증한다는 뜻으로 쓰시면 안 됩니다 — 로고도 쓰지 마세요.
GDELT Project 무력충돌	`Source: The GDELT Project (https://www.gdeltproject.org/)` 상업적 이용·재배포를 명시로 허용하되 인용과 링크를 함께 요구합니다. 링크까지 걸어 주세요.
ReliefWeb(유엔 OCHA)	`Source: ReliefWeb (OCHA), CC BY 4.0 (https://reliefweb.int/)` CC BY 4.0 — 출처만 적으면 상업적 이용도 됩니다.
NOAA/NWS 쓰나미·우주기상	`Source: NOAA/NWS Tsunami Warning Center (not an official NWS product)` `Source: NOAA Space Weather Prediction Center (not an official NWS product)` 퍼블릭 도메인이되 고쳐서 공식 자료로 내놓는 것은 금지입니다. 저희가 칸을 덜어 드리므로, 받은 문구의 괄호를 꼭 같이 적어 주세요. 이름과 로고도 쓰지 마세요.
GDACS 유럽연합·유엔 재난경보	`Source: GDACS (European Commission / UN)` 창구(RSS)가 스스로 `<copyright>public domain</copyright>` 라고 밝히고 있습니다.
미국 CDC 감염병	`Source: U.S. CDC — also available free of charge at cdc.gov` 퍼블릭 도메인이되 조건이 넷입니다 — 그 가운데 "원문은 기관 홈에서 무료로 볼 수 있다"를 적으라는 것이 있어 문구에 넣어 두었습니다. 내용을 고치지 마세요.

확인은 저희가 러너에서 각 기관 약관을 직접 읽어서 했고, 읽은 문장을 레포의 docs/API_SOURCES.md 에 그대로 옮겨 두었습니다. 조건이 바뀌면 창구에서 빼고 이 표도 고칩니다.

답이 안 올 때

401	열쇠가 없거나 막혔습니다
429	오늘 몫을 다 썼습니다. 한국시간 자정에 다시 찹니다. `meta.used_today` 와 `meta.limit_per_day` 로 남은 몫을 미리 보실 수 있습니다

열쇠를 붙여 보내시면 초당 몇 번 같은 따로 된 제한은 없습니다 — 하루 몫 하나만 셉니다. 한꺼번에 받아 가셔도 됩니다.

월간 보고서

한 달이 끝나면 그 달을 월간 보고서로 얼려 둡니다 — 갈래별·나라별 건수, 규모가 큰 지진, 어느 기관에서 온 자료인지까지. 얼린 뒤에는 안 바뀝니다. 저희 저장소는 31일치만 들고 있어서, 지난달을 나중에 다시 세면 이미 빠져나간 기록이 있기 때문입니다. 보고서는 무료이고 링크를 그대로 쓰셔도 됩니다.

재난이슈룸 · 4dmixxai@gmail.com · 월간 보고서 · 상황판