API 기술 문서 · IPTC ninjs

한국 기사 API, 연동 안내.

기사 공급 API를 연동하는 매체 개발자를 위한 문서입니다. API 키와 접속 주소(Base URL)는 신청을 확인한 뒤 이메일로 보내 드립니다.

API 이용 신청 API·XML 비교 →

시작 전에

인증

모든 요청에 X-Api-Key 헤더로 키를 보냅니다.

market

목록과 기사 요청에는 반드시 market=kr 을 붙입니다. 붙여야 한국 기사가 나옵니다.

형식

JSON. 기사 전문은 IPTC ninjs 형식이고, 한국 기사는 한국어입니다.

갱신

목록은 최근 기사 위주입니다. 하루 한 번보다 10~30분 간격으로 조회하세요.

엠바고

보도 시각이 정해진 기사는 그 시각이 지나야 목록에 나타납니다.

분류

카테고리·지역 항목은 없습니다. 사이트 안의 분류는 매체가 직접 정합니다.

이용 흐름

1단계

목록 보기

GET /articles?market=kr 로 본문 없이 최근 기사 목록을 봅니다.

2단계

기사 받기

GET /articles/{id}?market=kr 로 기사 전문을 받습니다.

3단계

게재 보고

선택 사항. 게재한 주소를 POST /publications 로 알려 주세요.

엔드포인트

아래 경로는 키와 함께 안내받는 접속 주소(Base URL) 뒤에 붙입니다.

방식	경로	내용
`GET`	`/api/wire/v1/health`	서비스 상태. 키 없이 호출할 수 있습니다.
`GET`	`/api/wire/v1/me`	내 키 정보: 등록한 도메인과 지금까지의 이용 현황.
`GET`	`/api/wire/v1/articles?market=kr&limit=20&since=2026-09-28T06:00:00`	기사 목록: 제목·부제·출처·등록 시각·사진 포함 여부·본문 길이·이미 받은 기사인지. 본문은 없습니다. 최신순, limit 최대 100, since 를 주면 그 시각(한국시간) 이후 기사만.
`GET`	`/api/wire/v1/articles/{id}?market=kr`	IPTC ninjs 형식의 기사 전문. 같은 기사를 다시 받아도 이용량에서 차감되지 않습니다.
`POST`	`/api/wire/v1/publications`	게재 보고: 기사의 uri, 게재한 주소(url), 상태(published 또는 removed)를 보냅니다. 등록한 도메인의 주소만 받습니다.
`GET`	`/api/wire/v1/publications`	보낸 게재 보고 목록.

기사 전문의 주요 항목

ninjs 표준의 다른 항목이 함께 올 수 있습니다. 쓰지 않는 항목은 무시하면 됩니다.

항목	내용
`headline`	제목
`description_text`	부제
`body_text`	본문(일반 텍스트, 문단은 빈 줄로 구분)
`byline`	작성자 항목. 대개 보도자료를 낸 기관명이 들어옵니다
`source`	보도자료를 낸 기관
`versioncreated`	기사 등록 시각(한국시간, ISO 8601)
`associations.featuremedia`	대표 사진: 사진 주소·설명·출처(creditline)
`copyrightnotice`	기사와 함께 게재할 출처 표기 문구
`usageterms`	이용 조건
`uri`	기사 고유 식별자. 게재 보고에 씁니다

응답 예시 (일부)

2026년 9월 28일 실제 기사를 줄인 것입니다. 일부 항목은 생략했습니다.

GET /api/wire/v1/articles/1790550398401?market=kr

{
  "language": "ko",
  "versioncreated": "2026-09-28T08:06:30.497386+09:00",
  "headline": "속초시, 향후 4년 보건의료 정책에 시민 의견 담는다",
  "description_text": "2027~2030년 지역보건의료계획 수립 위한 주민 설문조사 실시",
  "body_text": "속초시가 2027년부터 2030년까지 추진할 보건의료 정책에 시민 의견을 반영하기 위해 …",
  "byline": "속초시",
  "source": "속초시",
  "associations": {
    "featuremedia": {
      "type": "picture",
      "renditions": { "original": { "href": "https://press.pedien.com/images/…png" } },
      "creditline": "속초시"
    }
  }
}

오류 코드

400잘못된 요청 또는 지원하지 않는 market 값
401API 키가 없거나 잘못됨
402키의 이용 한도 초과
404기사 없음: 삭제되었거나 엠바고 시각 전
409배포 기준을 충족하지 않는 기사(차감하지 않음)
422게재 보고 주소가 등록한 도메인이 아님

아직 키가 없으신가요?

기사 공급 페이지에서 신청해 주세요. 사이트를 확인한 뒤 키와 접속 주소를 이메일로 보내 드립니다.

API 이용 신청 →