Skip to main content
POST
기업 뉴스 검색

인증

pubrio-api-key
string
header
필수

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

본문

application/json
locations
string[]

ISO 3166-1 alpha-2(cca2) 코드로 지역을 필터링하는 데 사용됩니다. 자세한 내용은 필터 탭의 location 엔드포인트를 참조하세요.

예시:
company_locations
string[]

회사 본사 위치입니다. 자세한 내용은 필터 탭의 location 엔드포인트를 참고하세요.

예시:
companies
string<uuid>[]

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

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를 사용하세요.

예시:
categories
string[]

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

예시:

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

published_dates
string[]

발행 날짜 범위입니다. 최대값은 오늘 날짜입니다.

예시:
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

news_galleries
string[]

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

예시:
news_languages
string[]

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

예시:
is_expansion_signal_available
boolean

When true, attaches the resolved expansion signals (expansion_signals) to each news item and enables the expansion_signal_types / expansion_signal_polarities filters. Leave unset for the fastest search — the expansion join is only added when this flag is on.

expansion_signal_types
enum<string>[]

Return only news that produced an expansion signal of one of these types (uppercase slugs). Requires is_expansion_signal_available: true. Unknown slugs are ignored.

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

Return only news whose expansion signal carries one of these polarities. Requires is_expansion_signal_available: true. Combined with expansion_signal_types as AND.

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

응답

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

metadata
object

요청 컨텍스트: 반향된 filterscredit, topup_credit, total_credit_cost를 포함하는 profile 블록입니다.

data
object | null

응답 정보는 특정 API에 따라 다릅니다.