API 레퍼런스

뉴스

RDPLINE 뉴스 API는 계약 범위 내 다양한 매체의 뉴스 데이터를 발행일시 기준으로 제공합니다. 기사 본문과 원문 URL뿐 아니라 등록·수정·삭제 상태, 142개 상세 카테고리, 이미지·영상 메타데이터까지 서비스에 연동할 수 있습니다.

조회 방식 선택

같은 엔드포인트에서 paginationMethod만 변경하여 원하는 방식으로 조회할 수 있습니다.

인증 헤더

모든 요청은 발급받은 API Key를 X-API-KEY 헤더 값으로 전달합니다.

발급받은 API Key를 X-API-KEY 헤더 값으로 전달합니다.

페이지 기반 조회

paginationMethodPAGE로 전달하면 페이지 번호 기반으로 조회합니다. UI 페이징이나 전체 건수와 전체 페이지 수가 필요한 리포트에 적합합니다.

Request Body

페이지 기반 조회 고정값입니다. PAGE 를 전달합니다.
조회할 기사 발행일시의 시작일입니다. YYYY-MM-DD 형식으로 입력하며, 해당 날짜를 포함합니다.
조회할 기사 발행일시의 종료일입니다. YYYY-MM-DD 형식으로 입력하며, 해당 날짜를 포함합니다.
조회할 페이지 번호입니다. 첫 페이지는 1입니다.
한 번에 가져올 기사 수입니다. 호출 1회당 최대 500건 까지 가능합니다.

요청 본문 예시

{  "paginationMethod": "PAGE",  "publishedAtStart": "2026-02-10",  "publishedAtEnd": "2026-07-14",  "page": 1,  "size": 20}

Response

성공

페이지 조회에 성공하면 metaitems로 구성된 응답 객체가 돌아옵니다.

응답 객체 상세

현재 페이지, 요청 크기, 전체 기사 수와 전체 페이지 수를 담은 객체입니다.
검색 결과 기사 목록입니다.

meta 객체 상세

조회 방식입니다. PAGE 를 반환합니다.
현재 응답의 페이지 번호입니다.
현재 응답의 페이지당 기사 수입니다.
검색 조건에 해당하는 전체 기사 수입니다.
검색 조건과 size 기준으로 계산한 전체 페이지 수입니다.

응답 예시

{  "meta": {    "paginationMethod": "PAGE",    "page": 1,    "size": 1,    "totalCount": 21,    "totalPages": 21  },  "items": [    {      "articleId": "01KW3CW880PEC9WT844M2FFSXW",      "title": "'뚱바' 그릇·초코송이 동화책... 'K간식' 맛 넘어 추억 판다",      "body": "그릇·손난로 굿즈로 재탄생한 먹거리 빙그레 '뚱바 그릇', 와디즈서 6억 펀딩 미국·독일 등 해외서도 알림 신청 관심 1984년생 초코송이·고래밥은 동화로 \"먹는 재미 넘어 보고 즐기는 경험으로\"\r\n\r\n 오리온은 올해 4월 아이들이 좋아하는 대표 과자 초코송이와 고래밥 세계관을 창작 그림책으로 확장하고, 그림책 출간을 기념해 '동화 에디션' 패키지에 담긴 한정판 과자도 선보였다. 오리온 제공  해태아이스의 국민 아이스크림 쌍쌍바가 IT 액세서리 브랜드 미니덕트와 협업해 지난해 10월 와디즈에서 최초 공개한 '쌍쌍바 손난로 보조배터리'. 나무 막대 손잡이, 반으로 갈라지는 구조, 패키지 디자인 등을 모두 쌍쌍바처럼 구현했다. 와디즈 제공  빙그레가 프리미엄 도자기 브랜드 이도온화와 협업해 출시한 바나나맛우유 도자기 5종 식기 세트. 빙그레 제공  빙그레와 이도온화가 손잡고 지난달 19일 크라우드 펀딩 플랫폼 와디즈에서 선출시한 바나나맛우유 도자기 5종 세트 사용 예시. 바나나맛우유는 빙그레의 전체 매출 중 20%를 책임지는 효자 상품으로, 누적 100억 개 판매를 앞두고 있다. 빙그레 제공  오리온은 2011년 출시한 과자 참붕어빵을 본떠 만든 손난로 보조배터리 굿즈를 지난해 10월 선보였다. 주머니에 들어가는 아담한 크기와 귀여운 디자인으로 실제 붕어빵을 쥐는 듯한 감성을 전하는 게 특징이다. 와디즈 제공 ★ \"외국인 친구 선물로 딱이네.\" \"보관이 편해 1인 가구도 쓰기 좋겠다.\" () ★ '뚱바'(뚱뚱한 바나나우유)라는 별명으로 유명한 빙그레 바나나맛우유가 도자기 식기 세트로 재탄생한다는 소식에 사회관계망서비스(SNS)에 올라온 반응들이다. 1974년 출시 후 남녀노소 모두 애용하는 국민 음료로 자리 잡은 뚱바는 커피 등과 섞어 마시는 '편의점 음료 조합' 유행 덕에 이제 외국인 관광객 사이에서도 필수 아이템이 됐다. 뚱바에 대한 주목도가 다시금 높아지자 빙그레는 조선 후기 달항아리 도자기가 모티브인 바나나맛우유의 패키지를 활용한 뚱바 식기 세트를 최근 선보였다. 프리미엄 도자기 브랜드 이도온화와 협업한 이 제품은 전체 모양이 뚱바지만 분리하면 밥그릇, 국그릇, 반찬 그릇, 접시, 종지 등 식기 5종으로 쓸 수 있다. 노란색 바나나맛과 분홍색 딸기맛 두 가지 버전은 지난달 19일 크라우드 펀딩 플랫폼 와디즈에서 단독 선출시됐고, 향후 카카오톡 선물하기·이도온화 공식 스토어 등에서도 판매 예정이다. 와디즈에서 약 3주 동안 진행한 펀딩에는 1만여 명의 구매자가 달려들어 6억5,000만 원이 모였다. 글로벌 고객에게 오픈된 펀딩이 아니었는데도 와디즈 사전 출시 알람 신청에 미국 일본 싱가포르 대만 독일 등 세계 각국 이용자까지 몰리며 알림 신청자만 2만4,000여 명을 기록했다고 한다. 와디즈 관계자는 \"한정판이라는 희소성에 더해 뚱바 브랜드 팬덤이 맞물려 높은 관심을 불렀고, 해외 수요까지 확인됐다\"고 설명했다. 빙그레 산하 브랜드 해태아이스가 지난해 10월 출시한 '쌍쌍바 손난로 보조배터리'도 와디즈 펀딩에서 6억8,000만 원을 끌어모았다. 쌍쌍바도 1979년 출시된 장수 브랜드인데, 반으로 갈라 나눠 먹는 제품 특징에다 초콜릿향 시향지 동봉 등 디테일이 살아 있는 굿즈로 거듭나 2030세대에게 큰 호응을 얻었다. 빙그레 관계자는 \"바나나맛우유와 쌍쌍바 모두 출시한 지 수십 년은 된 친숙한 제품이지만 굿즈라는 형태를 통해 젊은 소비자와 접점을 늘리고 새로운 브랜드 경험을 주고자 했다\"며 \"외부 지식재산권(IP) 협업과 달리 우리 제품을 굿즈화할 경우 브랜드 헤리티지를 강화할 수 있다는 장점이 있다\"고 설명했다. 오리온이 2011년 출시한 참붕어빵도 지난해 손난로 보조배터리로 나왔다. 귀여운 그림체의 참붕어빵 모양을 그대로 본뜬 데다 실제 과자 증정 이벤트도 열어 와디즈에서 나흘 만에 준비한 8,000개 물량이 완판되며 2억여 원 펀딩을 달성했다. 오리온은 올해 4월 출판사 김영사의 제안으로 1984년 출시한 대표 과자 초코송이와 고래밥 캐릭터가 주인공인 그림책도 선보였다. 아이들은 물론 부모 세대에게도 친숙한 두 과자를 책으로 재해석해 먹는 즐거움을 넘어 '보고 읽고 즐기는 경험'으로 확장한 것이다. 오리온 관계자는 \"외부 IP 협업이 화제성을 만드는 데 강점이 있다면 자사 브랜드 IP는 오랜 기간 소비자들과 쌓아온 친숙함과 추억을 바탕으로 브랜드 고유 자산을 축적한다는 장점이 있다\"면서 \"우리 IP를 활용해 소비자들이 단순 제품 구매를 넘어 브랜드가 가진 이야기와 감성을 경험할 수 있도록 하겠다\"고 밝혔다. 최나실 기자 verite@hankookilbo.com",      "characterCount": 2258,      "outletName": "한국일보",      "articleUrl": "https://www.hankookilbo.com/news/article/A2026061910030000605",      "authors": [        "최나실"      ],      "categories": [        "경제"      ],      "language": "ko",      "status": "INSERTED",      "publishedAt": "2026-06-19T10:03:00+09:00",      "modifiedAt": "",      "deletedAt": "",      "imageCount": 5,      "imageUrls": [        "https://newsimg.hankookilbo.com/cms/articlerelease/2026/06/19/8354e86d-06e6-4d1e-b8f0-b66def254734.jpg#W[1440]H[950]P[189]",        "https://newsimg.hankookilbo.com/cms/articlerelease/2026/06/19/82e64f5f-572b-4cc9-9c1a-bffeff117c4f.jpg#W[860]H[590]P[374]",        "https://newsimg.hankookilbo.com/cms/articlerelease/2026/06/19/18a9f646-d9a6-4b98-bd63-ed515af2c4a8.jpg#W[720]H[537]P[610]",        "https://newsimg.hankookilbo.com/cms/articlerelease/2026/06/19/786760c4-8916-4e2e-bf84-5a3c0783f16e.jpg#W[720]H[720]P[715]",        "https://newsimg.hankookilbo.com/cms/articlerelease/2026/06/19/3283b540-59c8-430b-bb08-86a21ccb6f10.jpg#W[900]H[568]P[949]"      ],      "videoCount": 0,      "videoUrls": []    }  ]}

커서 기반 조회

paginationMethod를 CURSOR 로 전달하면 nextCursor를 이어 받아 순차 조회합니다. 최초 호출에서는 cursor를 생략하고, meta.isEnd가 true가 될 때까지 직전 응답의 meta.nextCursor를 그대로 전달합니다.

Request Body

커서 기반 조회 고정값입니다. CURSOR 를 전달합니다.
한 번에 가져올 기사 수입니다. 호출 1회당 최대 500건 까지 가능합니다.
직전 응답의 meta.nextCursor입니다. 최초 호출 시에는 생략합니다.

최초 호출 요청 본문 예시

{  "paginationMethod": "CURSOR",  "size": 100}

반복 호출 요청 본문 예시

{  "paginationMethod": "CURSOR",  "size": 100,  "cursor": "01BX5ZZKBK0000000000000000"}

Response

성공

커서 조회에 성공하면 metaitems로 구성된 응답 객체가 돌아옵니다.

응답 객체 상세

요청 크기, 다음 조회 커서와 순회 종료 여부를 담은 객체입니다.
검색 결과 기사 목록입니다.

meta 객체 상세

조회 방식입니다. CURSOR 를 반환합니다.
현재 응답의 페이지당 기사 수입니다.
다음 호출 시 커서로 사용되는 articleId 입니다.
true면 더 이상 조회할 뉴스 데이터가 없음을 의미합니다.

응답 예시

{  "meta": {    "paginationMethod": "CURSOR",    "size": 1,    "nextCursor": "2026-06-19T10:03:00+09:00|1",    "isEnd": false  },  "items": [    {      "articleId": "01KW3CW880PEC9WT844M2FFSXW",      "title": "'뚱바' 그릇·초코송이 동화책... 'K간식' 맛 넘어 추억 판다",      "body": "그릇·손난로 굿즈로 재탄생한 먹거리 빙그레 '뚱바 그릇', 와디즈서 6억 펀딩 미국·독일 등 해외서도 알림 신청 관심 1984년생 초코송이·고래밥은 동화로 \"먹는 재미 넘어 보고 즐기는 경험으로\"\r\n\r\n 오리온은 올해 4월 아이들이 좋아하는 대표 과자 초코송이와 고래밥 세계관을 창작 그림책으로 확장하고, 그림책 출간을 기념해 '동화 에디션' 패키지에 담긴 한정판 과자도 선보였다. 오리온 제공  해태아이스의 국민 아이스크림 쌍쌍바가 IT 액세서리 브랜드 미니덕트와 협업해 지난해 10월 와디즈에서 최초 공개한 '쌍쌍바 손난로 보조배터리'. 나무 막대 손잡이, 반으로 갈라지는 구조, 패키지 디자인 등을 모두 쌍쌍바처럼 구현했다. 와디즈 제공  빙그레가 프리미엄 도자기 브랜드 이도온화와 협업해 출시한 바나나맛우유 도자기 5종 식기 세트. 빙그레 제공  빙그레와 이도온화가 손잡고 지난달 19일 크라우드 펀딩 플랫폼 와디즈에서 선출시한 바나나맛우유 도자기 5종 세트 사용 예시. 바나나맛우유는 빙그레의 전체 매출 중 20%를 책임지는 효자 상품으로, 누적 100억 개 판매를 앞두고 있다. 빙그레 제공  오리온은 2011년 출시한 과자 참붕어빵을 본떠 만든 손난로 보조배터리 굿즈를 지난해 10월 선보였다. 주머니에 들어가는 아담한 크기와 귀여운 디자인으로 실제 붕어빵을 쥐는 듯한 감성을 전하는 게 특징이다. 와디즈 제공 ★ \"외국인 친구 선물로 딱이네.\" \"보관이 편해 1인 가구도 쓰기 좋겠다.\" () ★ '뚱바'(뚱뚱한 바나나우유)라는 별명으로 유명한 빙그레 바나나맛우유가 도자기 식기 세트로 재탄생한다는 소식에 사회관계망서비스(SNS)에 올라온 반응들이다. 1974년 출시 후 남녀노소 모두 애용하는 국민 음료로 자리 잡은 뚱바는 커피 등과 섞어 마시는 '편의점 음료 조합' 유행 덕에 이제 외국인 관광객 사이에서도 필수 아이템이 됐다. 뚱바에 대한 주목도가 다시금 높아지자 빙그레는 조선 후기 달항아리 도자기가 모티브인 바나나맛우유의 패키지를 활용한 뚱바 식기 세트를 최근 선보였다. 프리미엄 도자기 브랜드 이도온화와 협업한 이 제품은 전체 모양이 뚱바지만 분리하면 밥그릇, 국그릇, 반찬 그릇, 접시, 종지 등 식기 5종으로 쓸 수 있다. 노란색 바나나맛과 분홍색 딸기맛 두 가지 버전은 지난달 19일 크라우드 펀딩 플랫폼 와디즈에서 단독 선출시됐고, 향후 카카오톡 선물하기·이도온화 공식 스토어 등에서도 판매 예정이다. 와디즈에서 약 3주 동안 진행한 펀딩에는 1만여 명의 구매자가 달려들어 6억5,000만 원이 모였다. 글로벌 고객에게 오픈된 펀딩이 아니었는데도 와디즈 사전 출시 알람 신청에 미국 일본 싱가포르 대만 독일 등 세계 각국 이용자까지 몰리며 알림 신청자만 2만4,000여 명을 기록했다고 한다. 와디즈 관계자는 \"한정판이라는 희소성에 더해 뚱바 브랜드 팬덤이 맞물려 높은 관심을 불렀고, 해외 수요까지 확인됐다\"고 설명했다. 빙그레 산하 브랜드 해태아이스가 지난해 10월 출시한 '쌍쌍바 손난로 보조배터리'도 와디즈 펀딩에서 6억8,000만 원을 끌어모았다. 쌍쌍바도 1979년 출시된 장수 브랜드인데, 반으로 갈라 나눠 먹는 제품 특징에다 초콜릿향 시향지 동봉 등 디테일이 살아 있는 굿즈로 거듭나 2030세대에게 큰 호응을 얻었다. 빙그레 관계자는 \"바나나맛우유와 쌍쌍바 모두 출시한 지 수십 년은 된 친숙한 제품이지만 굿즈라는 형태를 통해 젊은 소비자와 접점을 늘리고 새로운 브랜드 경험을 주고자 했다\"며 \"외부 지식재산권(IP) 협업과 달리 우리 제품을 굿즈화할 경우 브랜드 헤리티지를 강화할 수 있다는 장점이 있다\"고 설명했다. 오리온이 2011년 출시한 참붕어빵도 지난해 손난로 보조배터리로 나왔다. 귀여운 그림체의 참붕어빵 모양을 그대로 본뜬 데다 실제 과자 증정 이벤트도 열어 와디즈에서 나흘 만에 준비한 8,000개 물량이 완판되며 2억여 원 펀딩을 달성했다. 오리온은 올해 4월 출판사 김영사의 제안으로 1984년 출시한 대표 과자 초코송이와 고래밥 캐릭터가 주인공인 그림책도 선보였다. 아이들은 물론 부모 세대에게도 친숙한 두 과자를 책으로 재해석해 먹는 즐거움을 넘어 '보고 읽고 즐기는 경험'으로 확장한 것이다. 오리온 관계자는 \"외부 IP 협업이 화제성을 만드는 데 강점이 있다면 자사 브랜드 IP는 오랜 기간 소비자들과 쌓아온 친숙함과 추억을 바탕으로 브랜드 고유 자산을 축적한다는 장점이 있다\"면서 \"우리 IP를 활용해 소비자들이 단순 제품 구매를 넘어 브랜드가 가진 이야기와 감성을 경험할 수 있도록 하겠다\"고 밝혔다. 최나실 기자 verite@hankookilbo.com",      "characterCount": 2258,      "outletName": "한국일보",      "articleUrl": "https://www.hankookilbo.com/news/article/A2026061910030000605",      "authors": [        "최나실"      ],      "categories": [        "경제"      ],      "language": "ko",      "status": "INSERTED",      "publishedAt": "2026-06-19T10:03:00+09:00",      "modifiedAt": "",      "deletedAt": "",      "imageCount": 5,      "imageUrls": [        "https://newsimg.hankookilbo.com/cms/articlerelease/2026/06/19/8354e86d-06e6-4d1e-b8f0-b66def254734.jpg#W[1440]H[950]P[189]",        "https://newsimg.hankookilbo.com/cms/articlerelease/2026/06/19/82e64f5f-572b-4cc9-9c1a-bffeff117c4f.jpg#W[860]H[590]P[374]",        "https://newsimg.hankookilbo.com/cms/articlerelease/2026/06/19/18a9f646-d9a6-4b98-bd63-ed515af2c4a8.jpg#W[720]H[537]P[610]",        "https://newsimg.hankookilbo.com/cms/articlerelease/2026/06/19/786760c4-8916-4e2e-bf84-5a3c0783f16e.jpg#W[720]H[720]P[715]",        "https://newsimg.hankookilbo.com/cms/articlerelease/2026/06/19/3283b540-59c8-430b-bb08-86a21ccb6f10.jpg#W[900]H[568]P[949]"      ],      "videoCount": 0,      "videoUrls": []    }  ]}

NewsArticle 객체

items 배열에 포함되는 기사 객체입니다.

기사 고유 식별자입니다. 26자리 ULID 형식을 사용합니다.
기사 제목입니다.
기사 본문입니다. 본문이 제공되지 않는 경우 빈 문자열("")을 반환합니다.
본문(body)의 공백 포함 문자 수입니다. Unicode 기준으로 계산하며, 본문이 비어 있으면 0을 반환합니다.
기사를 발행한 매체명입니다.
원문 기사 URL입니다.
기사 작성자 목록입니다. 작성자 정보가 없으면 빈 배열([])을 반환합니다.
기사 카테고리입니다. RDPLINE 내부 142개 상세 카테고리 분류 체계에 따라 반환하며, 분류된 카테고리가 없으면 빈 배열([])을 반환합니다.
기사 언어 코드입니다. ISO 639-1 language code 규격을 사용합니다. (예: ko) 언어 정보가 없으면 빈 문자열("")을 반환합니다.
현재 기사 발행 상태값입니다. INSERTED, UPDATED, DELETED 중 하나를 반환합니다.
기사 발행일시입니다. ISO 8601 형식으로 반환합니다. 예: 2026-05-31T08:42:11+09:00
기사 수정일시입니다. ISO 8601 형식으로 반환하며, 수정 이력이 없으면 빈 문자열("")을 반환합니다.
기사 삭제일시입니다. ISO 8601 형식으로 반환하며, 삭제되지 않은 기사는 빈 문자열("")을 반환합니다.
기사에 포함된 이미지 수입니다. 이미지가 없으면 0을 반환합니다.
기사 이미지 URL 목록입니다. 이미지가 없으면 빈 배열([])을 반환합니다.
기사에 포함된 비디오 수입니다. 비디오가 없으면 0을 반환합니다.
기사 비디오 URL 목록입니다. 비디오가 없으면 빈 배열([])을 반환합니다.