뉴스 API · IPTC ninjs 2.1
구독이 아니라 기사 단위로.
PEDIEN Wire는 매체가 필요한 기사를 직접 가져가는 방식의 API입니다. 목록은 무료로 보고, 전문을 가져간 기사만 과금합니다. 같은 기사를 다시 가져가면 과금하지 않습니다.
지금 제공
미국 공공기관 뉴스
미국 연방기관과 공공기관의 보도자료를 상투구를 걷어내고 ninjs 형식으로 정리했습니다. 이미지 출처는 표준 필드에 담습니다. 게재하기에 너무 짧은 기사는 과금 전에 걸러냅니다.
준비 중
한국 지역 뉴스 영문판
한국 시·도의 기사를 해외 독자를 위해 영어로 옮겨 제공할 예정입니다. 먼저 받아 보고 싶으시면 알려 주세요.
이용 방법
1단계
키 발급
선불 크레딧이 담긴 API 키를 발급합니다. X-Api-Key 헤더로 보내면 됩니다.
2단계
무료로 목록 보기
GET /articles 로 제목·출처·길이를 보고, 이미 받은 기사도 확인합니다.
3단계
기사당 과금
GET /articles/{id} 로 ninjs 전문을 받고 1크레딧이 차감됩니다. 다시 받으면 무료입니다.
엔드포인트
접속 주소(Base URL)는 키와 함께 안내해 드립니다.
| 방식 | 경로 | 내용 | 비용 |
|---|---|---|---|
GET | /api/wire/v1/health | 서비스 상태 | 무료 · 키 불필요 |
GET | /api/wire/v1/me | 잔액과 사용량 | 무료 |
GET | /api/wire/v1/articles?market=us&limit=20&since=… | 기사 목록: 제목·출처·길이·이미 받은 기사 여부. 본문 없음. | 무료 |
GET | /api/wire/v1/articles/{id} | IPTC ninjs 2.1 형식의 기사 전문(이미지 출처 필드 포함) | 1크레딧 · 같은 기사 재조회 무료 |
오류 코드
- 401API 키가 없거나 잘못됨
- 402크레딧 소진
- 409게재하기에 너무 짧은 기사(과금 전에 확인)
응답 예시
{
"market": "us",
"count": 2,
"items": [
{
"uri": "urn:pedien:wire:us:1790339406953",
"id": "1790339406953",
"headline": "NASA to Study Human Health, Performance During Crew-13 Mission",
"source": "NASA",
"versioncreated": "2026-09-25T21:30:06+09:00",
"has_image": true,
"body_chars": 4993,
"already_taken": false
},
{
"uri": "urn:pedien:wire:us:1790339404113",
"headline": "NASA Unveils Winning Designs for Mars Space Food Systems Challenge",
"source": "NASA",
"body_chars": 5444,
"already_taken": true
}
]
}