Skip to main content
POST
기업 뉴스 검색

인증

pubrio-api-key
string
header
필수

API에서 수행하는 작업 및 해당 권한을 식별하는 고유한 API 토큰입니다. 이 토큰은 설정 섹션에서 생성할 수 있습니다.

본문

application/json
locations
string[]

기사 내용 자체가 다루는 국가로, 기사 본문에서 읽어 냅니다(ISO 3166-1 alpha-2). 기사에 장소가 없으면 비어 있습니다. 기사에 언급된 회사의 본사 국가로 찾으려면 company_locations를 사용하세요.

예시:
company_locations
string[]

기사에 언급된 회사의 본사 국가(ISO 3166-1 alpha-2)이며, 사건이 일어난 장소가 아닙니다. 그 경우에는 locations를 사용하세요.

예시:
companies
string<uuid>[]

회사 및 인물 조회 작업을 위한 고유 식별자(domain_search_id) 목록.

news_search_id
string<uuid>

이 레코드 하나만 반환합니다. 이전에 저장한 행을 페이징 없이 다시 가져올 때 편리합니다.

예시:

"4110b929-17cd-42aa-a159-906ead0c9b56"

domains
string[]

회사 및 인물 조회 작업에 사용되는 회사 도메인 목록입니다. 입력된 주소가 www.pubrio.com 또는 https://docs.pubrio.com/인 경우, 시스템은 이를 자동으로 pubrio.com으로 변환하여 처리합니다.

예시:
linkedin_urls
string[]

LinkedIn 회사 페이지의 전체 URL입니다. http로 시작하며 linkedin.com/company/를 포함해야 합니다.

예시:
search_term
string

결과를 필터링하기 위한 키워드 문자열입니다.

예시:

"pubrio"

search_terms
string[]

뉴스 기사를 필터링하기 위한 키워드 문자열 배열입니다. 각 키워드는 기사 내용과 매칭됩니다. 단일 문자열에는 search_term을, 여러 키워드에는 search_terms를 사용하세요.

예시:
exclude_search_terms
string[]

이 단어 중 하나라도 언급한 기사를 제외합니다. 일치 방식은 search_terms와 같습니다. exclude_keywords라는 이름도 사용할 수 있습니다.

예시:
sources
string[]

지정한 발행처의 기사만 반환합니다. 발행처 도메인을 사용하세요(예: bbc.co.uk, 각 기사의 source 필드와 같은 값). 전체 URL이나 www. 주소도 사용할 수 있습니다.

예시:
exclude_sources
string[]

지정한 발행처의 기사를 제외합니다. 형식은 sources와 같습니다. 발행처가 기록되지 않은 기사는 유지됩니다.

예시:
categories
string[]

category slugs 목록으로, 특정 뉴스 카테고리를 검색합니다. slug를 얻으려면 필터 탭의 news categories 엔드포인트를 호출하세요.

예시:

news_gallery_id 목록으로, 특정 뉴스 갤러리를 검색할 때 사용됩니다. ID를 얻으려면 필터 탭의 news galleries 엔드포인트를 호출하세요.

published_dates
string[]

발행 날짜 범위입니다. 최대값은 오늘 날짜입니다. 날짜 경계는 워크스페이스 시간대를 따릅니다.

예시:
published_at
string<date-time>

이 시각 이후에 게시됨(UTC). 날짜 또는 ISO 타임스탬프. published_dates는 닫힌 범위 형식이며 워크스페이스 시간대를 사용합니다.

예시:

"2026-09-01T00:00:00Z"

per_page
integer
기본값:25

페이지당 레코드 수입니다. 기본값은 25이며 대부분의 플랜에서 상한이기도 합니다. 이 한도는 구독의 max_search_per_page이며 Profile에서 확인할 수 있습니다. 초과하면 결과가 잘리는 것이 아니라 HTTP 416과 코드 41676(기업·인물 검색은 41613)이 반환됩니다.

필수 범위: x <= 25
예시:

25

page
integer
기본값:1

페이지 번호이며 1부터 시작합니다. 상한은 구독의 max_search_page(기업 검색은 max_company_search_page)이며 Profile에서 확인할 수 있습니다. 초과하면 HTTP 416이 반환됩니다.

예시:

1

is_ascending_order
boolean
기본값:false

정렬 방향입니다. 기본값은 최신순이며 true로 설정하면 오래된 순으로 반환합니다. 이 엔드포인트에는 sort_by가 없으며, 정렬 키는 고정되어 엔드포인트 설명에 명시되어 있습니다.

예시:

false

news_galleries
string[]

갤러리별로 뉴스를 필터링하기 위한 gallery slug 목록입니다. slug를 확인하려면 필터 탭의 news galleries 엔드포인트를 호출하세요.

예시:
news_languages
string[]

언어별로 뉴스를 필터링하기 위한 locale_code 값 목록입니다. 사용 가능한 코드를 확인하려면 필터 탭의 news languages 엔드포인트를 호출하세요.

예시:
is_expansion_signal_available
boolean

true이면 해석된 확장 시그널(expansion_signals)이 각 뉴스 항목에 첨부되고 expansion_signal_types / expansion_signal_polarities 필터가 활성화됩니다. 가장 빠른 검색을 원하면 설정하지 마세요. 이 플래그가 켜져 있을 때만 확장 조인이 추가됩니다.

expansion_signal_types
enum<string>[]

이 유형 중 하나의 확장 시그널을 생성한 뉴스만 반환합니다(대문자 슬러그). is_expansion_signal_available: true가 필요합니다. 알 수 없는 슬러그만 있는 목록은 아무것도 일치하지 않습니다.

사용 가능한 옵션:
AD,
AUDIENCE,
DNS,
ENTITY,
EVENT,
EVENT_PLUS,
EXEC,
HIRE,
INFRA,
IP,
NEWS,
OFFICE,
PARTNER,
PRODUCT,
REG,
SCALE,
TECH
예시:
expansion_signal_polarities
enum<string>[]

확장 시그널이 이 극성 중 하나를 가진 뉴스만 반환합니다. is_expansion_signal_available: true가 필요합니다. expansion_signal_types와는 AND로 결합됩니다.

사용 가능한 옵션:
expansion,
contraction_leading,
contraction_confirming,
contraction_lagging
예시:

응답

관련 세부 정보가 포함된 성공적인 응답입니다.

metadata
object

요청 컨텍스트입니다.

data
object
마지막 수정일 2025년 12월 8일