연합뉴스 유료 FEED

제공 카테고리 12

연합뉴스 홈페이지 카테고리 기준입니다. 목록에 없는 카테고리는 별도로 문의해 주세요. 아래 링크는 홈페이지의 해당 카테고리 페이지이며, 피드 주소는 계약 후 이용하실 카테고리에 맞춰 업체별로 발급해 드립니다. 하나의 기사는 여러 카테고리에 포함될 수 있습니다.

샘플 데이터

연동 개발 시 응답 구조를 먼저 확인해 보세요.

기사 피드 필드 /sample/main.xml

기본 XML 피드의 요소별 정의입니다. RSS 2.0 기반이며 확장 네임스페이스는 사용하지 않습니다. 문자 인코딩은 UTF-8입니다. 아래 정의는 기본 포맷 기준이며, 계약에 따라 조정될 수 있습니다.

<rss version="2.0">
  <channel>
    <title>YonhapNews</title>
    <link>https://www.yna.co.kr</link>
    <description>YonhapNews</description>
    <lastBuildDate>Wed, 8 Apr 2026 08:46:35 +0900</lastBuildDate>
    <generator>YNA Feed Generate System</generator>

    <item>
      <guid isPermaLink="false">AKR20260408029800009</guid>
      <title><![CDATA[ 기사 제목 ]]></title>
      <link><![CDATA[ https://www.yna.co.kr/view/AKR20260408029800009?input=feed_abccorp ]]></link>
      <enclosure url="https://img2.yna.co.kr/photo/.../..._P4.jpg" type="image/jpeg"/>
      <description><![CDATA[ <h2><p>부제</p></h2> <figure>...</figure> <p>본문</p> ]]></description>
      <pubDate>Wed, 8 Apr 2026 08:34:48 +0900</pubDate>
      <keyword><![CDATA[ 이란;종전;휴전;트럼프 ]]></keyword>
    </item>

  </channel>
</rss>

오디오 피드 필드 /sample/audio.xml

오디오 뉴스 피드는 팟캐스트 규격을 따릅니다. RSS 2.0에 xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd" 네임스페이스를 선언해 확장 요소를 사용합니다.

<rss xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd" version="2.0">
  <channel>
    <ttl>3</ttl>
    <title>연합뉴스 오디오 뉴스</title>
    <language>kr</language>
    <copyright>Copyright (C) Yonhapnews</copyright>
    <itunes:owner>
      <itunes:name>연합뉴스 오디오 뉴스</itunes:name>
      <itunes:email>…@yna.co.kr</itunes:email>
    </itunes:owner>
    <category>News</category>
    <itunes:image href="https://r.yna.co.kr/.../yonhapnews_logo_1600x1600_kr.png"/>

    <item>
      <title><![CDATA[ 기사 제목 ]]></title>
      <description><![CDATA[ 기사 제목 ]]></description>
      <enclosure url="https://cdnvod.yonhapnews.co.kr/.../a6f95032-….mp3"
                 length="408807" type="audio/mpeg"/>
      <guid isPermaLink="false">a6f95032-6574-481d-aa30-10cd5c798d9e</guid>
      <pubDate>Wed, 8 Apr 2026 06:45:55 +0900</pubDate>
      <itunes:duration>00:51</itunes:duration>
      <itunes:keywords>연합뉴스, 한국뉴스</itunes:keywords>
    </item>

  </channel>
</rss>

두 피드의 차이

같은 RSS 2.0이지만 스키마가 다릅니다. 두 피드를 함께 수신한다면 파서를 분리하는 편이 안전합니다.

조회 주기와 캐싱 권장 1분

피드는 3분마다 다시 생성됩니다. 조회는 그보다 촘촘하게 잡는 편이 안전합니다.

• 정확히 3분 간격으로 맞추면 조회 시점이 생성 직전에 걸릴 때 최대 6분 가까이 묵은 데이터를 받게 됩니다.
• 1분 주기면 갱신 후 늦어도 1분 안에 확인됩니다.
• 세 번 중 두 번은 직전과 같은 내용이 내려옵니다. 정상입니다. guid로 이미 수신한 항목을 걸러내면 됩니다.
• 1분보다 짧게 잡을 필요는 없습니다. 생성 주기가 3분이라 새 데이터가 나오지 않고 요청만 늘어납니다.
• 여러 카테고리를 함께 수신한다면 매분 0초에 몰아서 호출하지 말고 몇 초씩 어긋나게 배치해 주세요. 카테고리 수만큼 동시 요청이 발생합니다.
• 회차당 제공 건수는 기본 30건이며, 계약에 따라 조정될 수 있습니다.
• 조회에 실패해도 즉시 재시도할 필요는 없습니다.
• 회차마다 30건이 겹쳐 내려오므로 한두 번 건너뛰어도 그 사이 기사는 다음 조회에서 함께 받습니다.

연동 시 확인해 주세요

• CDATA로 감싼 값에는 앞뒤 공백이 포함됩니다. title, link, keyword 모두 trim 후 저장하세요.
• 날짜의 일(day)이 한 자리일 때 08이 아니라 8로 표기됩니다. RFC 822를 엄격하게 해석하는 파서에서는 실패할 수 있으니 두 경우를 모두 처리하세요.
• description 안에서 <h2>가 <p>를 감싸고 있습니다. HTML 표준상 허용되지 않는 중첩이라 브라우저나 새니타이저가 <h2>를 앞에서 닫아버릴 수 있습니다. 부제를 따로 추출한다면 사용하는 파서의 동작을 먼저 확인하세요.
• keyword는 RSS 표준 밖의 요소입니다. Rome 같은 라이브러리는 기본 설정에서 이 값을 버리므로, 커스텀 모듈을 등록하거나 XML을 직접 파싱해야 합니다.
• 이미지 호스트는 하나가 아닙니다. img.yna.co.kr과 img1.yna.co.kr부터 img9.yna.co.kr까지 분산되어 있고, 같은 기사 안에서도 enclosure와 본문 <img>의 호스트가 다를 수 있습니다. 방화벽이나 이미지 프록시 정책은 img*.yna.co.kr 전체를 허용하도록 잡아 주세요.
• 사진 설명 아래의 재판매·DB 금지 문구는 저작권 표기이므로 본문을 가공하더라도 함께 노출해 주세요.
• 제공 건수는 기본 30건이지만 계약에 따라 조정될 수 있습니다. 건수를 코드에 고정하지 마시고, 받으신 항목을 그대로 순회해 처리하세요.
• 권장 주기(1분)로 조회하면 회차 간 목록이 크게 겹치므로 누락 위험은 거의 없습니다. 다만 갱신 주기 안에 제공 건수를 넘겨 송고되는 경우에 대비해 수신한 guid 목록을 유지하면서 직전 회차와 겹치는 구간이 있는지 확인하세요.
• 하나의 기사가 여러 카테고리에 포함될 수 있습니다. 두 개 이상의 카테고리를 함께 수신하시면 같은 guid가 서로 다른 피드에서 내려옵니다. 중복 판정은 카테고리별로 나누지 마시고 guid 하나를 기준으로 처리하세요.
• 오디오 뉴스는 대응하는 기사 원문이 없는 별도 콘텐츠입니다. 그래서 <item>에 <link>가 없고, guid도 기사 ID 체계와 무관합니다. 기사 피드와 조인하려 하지 마시고 각각 독립된 콘텐츠로 다뤄 주세요.
• 오디오 파일은 cdnvod.yonhapnews.co.kr에서 내려받습니다. 이미지 호스트와 별개이므로 방화벽 정책에 함께 추가해 주세요.
• 두 피드의 키워드 구분자가 다릅니다. 기사 피드는 세미콜론, 오디오 피드는 쉼표입니다. 공통 파싱 로직을 쓴다면 구분자를 피드별로 넘기세요.

접속 및 계약