API 레퍼런스

뉴스 논문 통합 검색

RDPLINE 뉴스 논문 통합 검색 API를 통해 뉴스와 논문 메타정보를 한번에 검색할 수 있습니다. 계약 매체·기간과 무관하게 전체 코퍼스를 대상으로 검색하며 본문을 제외한 메타정보만 제공합니다.

POST /collections/search

요청 본문에 검색어와 필요한 조건을 전달합니다.

POST https://api.rdpline.com/collections/search

Request Body

query

·string

검색 키워드. 뉴스와 논문에 공통으로 적용됩니다. 공백만 입력할 수 없습니다.

size

·integer

반환 건수(1~20). 생략시 10. 뉴스와 논문에 각각 적용됩니다.

publishedAtStart

·string

뉴스에만 적용되는 발행일 시작일입니다. yyyy-MM-dd 형식이며 해당일을 포함합니다.

publishedAtEnd

·string

뉴스에만 적용되는 발행일 종료일입니다. yyyy-MM-dd 형식이며 해당 날짜 하루 전체를 포함합니다.

scholarDateRange

·string

논문에만 적용되는 기간 필터입니다. past_day, past_week, past_month, past_year 중 하나를 소문자로 정확히 전달합니다. 생략하면 논문은 전 기간 대상입니다.

요청 예시

{  "query": "삼성전자",  "size": 10,  "publishedAtStart": "2026-07-01",  "publishedAtEnd": "2026-07-31",  "scholarDateRange": "past_year"}

Response

data

query

·string

요청 검색어를 그대로 반환합니다.

size

·integer

실제로 적용된 소스별 요청 건수입니다.

news

·object

뉴스 검색 소스 블록입니다. 성공·실패와 무관하게 항상 존재합니다.

scholar

·object

논문 검색 소스 블록입니다. 성공·실패와 무관하게 항상 존재합니다.

news / scholar 객체

errorCode

·string

실패 시에만 존재합니다. 있으면 해당 소스는 실패한 것입니다.

message

·string

실패 시에만 존재하는 영문 사유입니다.

totalCount

·integer

반환한 건수입니다. 실패 시 0, 성공 시 items.length입니다.

items

·array

결과 목록입니다. 실패 시 빈 배열입니다.

응답 예시

{  "success": true,  "data": {    "query": "삼성전자",    "size": 1,    "news": {      "totalCount": 1,      "items": [        {          "title": "삼성전자·SK하이닉스, 상승에 급등...특히 삼성전자 6% 상승",          "url": "http://www.econonews.co.kr/news/articleView.html?idxno=440648",          "outletName": "이코노뉴스",          "publishedAt": "2026-07-03T12:48:00",          "authors": [            "어 만 기자"          ],          "categories": [            "경제"          ]        }      ]    },    "scholar": {      "totalCount": 1,      "items": [        {          "title": "삼성전자 현 · 선물과 KOSPI 200 현 · 선물시장 간의 비대칭성",          "url": "http://www.dbpia.co.kr/Journal/ArticleDetail/NODE01840573",          "hostname": "dbpia.co.kr",          "faviconUrl": "https://www.google.com/s2/favicons?domain=http://www.dbpia.co.kr",          "description": "본 연구는 코스피 200 현·선물수익률과 삼성전자 현 선물수익률 간의...",          "publishedAt": "2011-12-01",          "citationCount": 0,          "authors": [            "문규현"          ],          "journal": "산업경제연구"        }      ]    }  }}

동작 정책

항목

동작

검색 범위

계약 스코프를 적용하지 않고 전체 매체·논문 코퍼스를 대상으로 검색합니다.

반환 범위

기사 본문, 발췌, 하이라이트, 이미지, 삭제 상태는 제공하지 않습니다.

정렬

관련도순 고정입니다. sort 요청 파라미터와 응답 필드는 없습니다.

페이지네이션

지원하지 않습니다. page, sort, sources 등 미지원 필드를 보내면 400입니다.

totalCount

반환 건수입니다. items.length와 동일합니다.

부분 실패

뉴스와 논문 소스는 독립적으로 처리되며, 실패 유형에 따라 응답 형태가 다릅니다.

요청 본문 검증, 인증, 권한, 처리율 제한 실패는 success: false 형식의 공통 오류 응답으로 반환됩니다.
뉴스 또는 논문 중 한 소스만 실패하면 HTTP 200 응답 안에서 해당 객체에만 errorCode와 message가 포함됩니다.
두 소스가 모두 실패하면 HTTP 504와 DEADLINE_EXCEEDED가 반환됩니다.

논문 소스 실패 예시

{  "success": true,  "data": {    "query": "삼성전자",    "size": 10,    "news": {      "totalCount": 1,      "items": [ ... ]    },    "scholar": {      "errorCode": "DEADLINE_EXCEEDED",      "message": "The scholar search provider did not respond in time.",      "totalCount": 0,      "items": []    }  }}

전체 실패 예시

{  "success": false,  "status": 504,  "message": "All search providers did not respond in time. Please try again later.",  "errorCode": "DEADLINE_EXCEEDED"}

NewsItem 객체

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

title

·string

기사 제목입니다.

url

·string

원문 기사 URL입니다. 별도 식별자 필드가 없으므로 참조 키로 사용합니다.

outletName

·string

매체명입니다.

publishedAt

·string

발행 일시 원본 문자열입니다. offset 없이 예: 2026-07-28T09:46:00 형식으로 올 수 있습니다.

authors

·array<string>

기자/작성자명입니다. 값이 없으면 빈 배열입니다.

ScholarItem 객체

scholar.items 배열에 포함되는 논문 객체입니다.

title

·string

논문 제목입니다.

url

·string

논문 URL입니다. http URL이 섞일 수 있으므로 클라이언트 링크 처리에 주의하십시오.

hostname

·string

출처 호스트명입니다.

faviconUrl

·string

Google 파비콘 서비스 URL입니다. 그대로 로드하면 조회 사실이 Google로 전달될 수 있습니다.

description

·string

설명/초록 요약입니다. HTML 태그가 섞일 수 있으므로 innerHTML로 삽입하지 마십시오.

publishedAt

·string

yyyy-MM-dd 또는 yyyy 형식입니다. 연도만 있는 값을 임의로 yyyy-01-01로 보정하지 마십시오.

citationCount

·integer

인용 수입니다. 값이 없으면 0입니다.

authors

·array<string>

논문 저자명입니다. 한글·영문 표기가 섞일 수 있습니다.

journal

·string

저널/학회명입니다. 값이 없으면 빈 문자열입니다.