Skip to main content
POST
회사 신호 이벤트

인증

pubrio-api-key
string
header
필수

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

본문

application/json
domain_search_id
string<uuid>
필수

회사 조회 작업의 고유 식별자.

signal_types
enum<string>[]

특정 신호 유형으로 필터링합니다. 정의와 등급은 지식 베이스의 신호 유형 카탈로그를 참조하세요(DNSINFRA는 Premier 등급 신호입니다).

사용 가능한 옵션:
AD,
NEWS,
DNS,
INFRA,
PARTNER,
EVENT_PLUS,
EXEC,
OFFICE,
HIRE,
SCALE,
PRODUCT
예시:
country_codes
string[]

선택 사항. 피드를 하나 이상의 해외 시장(ISO 3166-1 alpha-2, 예: ["JP","SG"])으로 좁힙니다. 생략하면 모든 해외 시장이 대상입니다(본국 시장은 항상 제외).

예시:
transitioned_dates
string<date>[]

신호/전환 윈도우에 대한 ISO [from, to] 날짜 범위입니다. window_days가 함께 제공된 경우 이 값이 우선합니다.

예시:
window_days
integer
기본값:90

선택 사항. 이벤트 롤링 윈도우의 일수입니다. 본 파라미터와 transitioned_dates 를 모두 생략하면 기본값으로 90 일(표준 표시 윈도우)이 사용됩니다. 둘 다 제공하면 transitioned_dates 가 우선합니다.

예시:

90

query
string

판매하는 제품이나 이 회사를 평가하는 기준이 되는 이상적인 구매자 프로필을 자연어로 설명합니다. AI summary의 근거로만 사용되며(is_explain_match 참고), 회사 검색과 달리 여기서는 필터 조건으로 해석되지 않습니다.

예시:

"We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity."

is_explain_match
boolean

true이고 query가 제공되면 data.summary에 이 회사의 확장 활동을 query에 비추어 해석한 단일 AI 요약이 반환됩니다. 회사의 실제 시그널을 근거로 [n] 인용이 포함됩니다. 회사 검색의 회사별 match_summary와 달리, 이 요약은 해당 기간의 회사 전체 시그널(모든 시장, 모든 시그널)을 바탕으로 생성되므로 page / per_page와 무관하게 일관됩니다.

예시:

true

domain
string

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

예시:

"pubrio.com"

linkedin_url
string

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

예시:

"https://www.linkedin.com/company/pubrio"

page
integer
기본값:1

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

예시:

1

per_page
integer
기본값:25

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

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

25

응답

200 - application/json

페이지네이션된 신호 이벤트입니다. is_explain_match가 true이고 query가 제공되면 data.summary에 회사 전체 시그널을 쿼리에 비추어 생성한 AI 요약({ text, citations })이 담기며, 그렇지 않으면 null입니다.

metadata
object
data
any