API reference

Collections Search

Search news and scholarly paper metadata at once with the RDPLINE Collections Search API.

POST /collections/search

Send the search keyword and any conditions in the request body.

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

Request Body

query

·string

Search keyword. Whitespace-only values are rejected.

size

·integer

Number of results returned per source, applied to news and papers separately. Only values from 1 to 20 are allowed; defaults to 10.

publishedAtStart

·string

Start publication date for news. yyyy-MM-dd format, inclusive of that date. Not applied to papers.

publishedAtEnd

·string

End publication date for news. yyyy-MM-dd format, inclusive of the entire day. Not applied to papers.

scholarDateRange

·string

Date bucket for paper search. One of past_day, past_week, past_month, or past_year; all periods when omitted.

Request example

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

Response

data

query

·string

Echoes the requested search keyword.

size

·integer

The per-source request size actually applied.

news

·object

News search source block. Always present regardless of success or failure.

scholar

·object

Scholarly paper source block. Always present regardless of success or failure.

news / scholar object

errorCode

·string

Present only on failure. If present, the source failed.

message

·string

English reason, present only on failure.

totalCount

·integer

Number of returned results. 0 on failure, items.length on success.

items

·array

List of results. An empty array on failure.

Response example

{  "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": "산업경제연구"        }      ]    }  }}

Behavior policy

Item

Behavior

Search scope

Searches the entire media and paper corpus without applying the contract scope.

Returned data

Article bodies, excerpts, highlights, images, and deletion status are not provided.

Sorting

Fixed to relevance order. The sort parameter is not supported.

Pagination

Not supported. Parameters such as page, sort, and sources cannot be used.

totalCount

Number of returned results. Equal to items.length.

Partial failures

News and paper sources are processed independently, and the response shape depends on the failure type.

Request validation failure — responds with the common success: false error format.
Single source failure — responds with HTTP 200, and the failed source block includes errorCode and message.
All sources failed — responds with HTTP 504 and DEADLINE_EXCEEDED.

Scholar source failure example

{  "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": []    }  }}

Total failure example

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

NewsItem object

The article object included in the news.items array.

title

·string

Article title.

url

·string

Source article URL. Acts as the identifier — there is no separate ID.

outletName

·string

Name of the outlet that published the article.

publishedAt

·string

Publication datetime. e.g. 2026-07-28T09:46:00

authors

·array<string>

List of reporter/author names. An empty array ([]) when absent.

ScholarItem object

The paper object included in the scholar.items array.

title

·string

Paper title.

url

·string

Paper URL. May include http URLs.

hostname

·string

Source hostname.

faviconUrl

·string

Source favicon URL. Returns a Google favicon service URL.

description

·string

Paper description or abstract. May contain HTML tags.

publishedAt

·string

Publication date. yyyy-MM-dd or yyyy format.

citationCount

·integer

Citation count. 0 when absent.

authors

·array<string>

List of paper author names. May mix Korean and English.

journal

·string

Journal or society name. An empty string ("") when absent.