Skip to main content
POST
모니터 생성

인증

pubrio-api-key
string
header
필수

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

본문

application/json
query
string
필수

모니터에 대한 자연어 설명(모든 언어). 예: "일본에 진출하는 기업을 모니터링하고 C-레벨 인물의 업무용 이메일을 받아 [email protected]으로 실시간 알림 전송". 동일한 요청에서 아래 필드(detection_mode, signal_types, signal_filters, people_enrichment_configs, destination_type/destination_config, frequency_minute)로 해석됩니다. 명시적으로 전달한 필드는 해석된 값보다 우선합니다. 텍스트가 모니터 요청이 아니면 400을 반환합니다. 최대 2000자.

Maximum string length: 2000
name
string

모니터의 이름입니다.

description
string

모니터의 설명입니다.

status
enum<string>
기본값:active

모니터를 생성할 때의 라이프사이클 상태입니다. 기본값은 active. draft를 사용하면 미완성 모니터를 저장할 수 있습니다(필수는 name뿐이며, 검증은 활성화 시점으로 미뤄지고 초안은 실행되지 않습니다).

사용 가능한 옵션:
draft,
active,
paused,
inactive
detection_mode
enum<string>

신호를 감지하는 방식입니다. signal_first는 시장 전반을 넓게 스캔하고, company_first는 지정한 계정 목록을 추적하며 기업, 도메인 또는 LinkedIn URL이 최소 하나 필요합니다. 생성 후에는 변경할 수 없습니다 — 기존 모니터에서 변경하면 40021이 반환됩니다. 새 모니터를 생성하세요.

사용 가능한 옵션:
company_first,
signal_first
signal_types
enum<string>[]

모니터링할 신호 유형입니다.

사용 가능한 옵션:
jobs,
news,
advertisements,
expansions,
cloud_footprints
signal_filters
object[]

모니터가 감시하는 시그널 스트림마다 한 항목.

예시:
company_filters
object

글로벌 기업 필터로 두 번째 레이어로 적용됩니다. Company Search 엔드포인트와 동일한 매개변수 — locations, employees, technologies, verticals 등을 허용합니다.

예시:
companies
string<uuid>[]

모니터링할 기업 domain_search_id UUID 목록입니다. 주로 company_first 모드에서 대상 기업을 지정하는 데 사용됩니다. domains 또는 linkedin_urls를 대안으로 사용할 수 있습니다 — 셋 중 하나만 입력하면 됩니다.

domains
string[]

모니터링할 회사 도메인 목록 (예: ["openai.com", "google.com"]). companies의 대안으로 사용 가능 — Pubrio가 해당 회사를 자동으로 확인합니다. companies, domains, linkedin_urls 중 하나만 입력하면 됩니다.

linkedin_urls
string<uri>[]

LinkedIn 회사 페이지 URL 목록 (예: ["https://linkedin.com/company/pubrio"]). companies의 대안으로 사용 가능합니다. 셋 중 하나만 입력하면 됩니다.

is_company_enrichment
boolean

결과에서 기업 데이터를 보강할지 여부입니다.

is_people_enrichment
boolean

결과에서 인물 데이터를 보강할지 여부입니다.

people_enrichment_configs
object[]

인물 보강 레이어 배열입니다. 각 레이어는 독립적인 인물 검색을 수행합니다. max_people_to_return (1-25), people_contact_types (배열 — Redeem 엔드포인트의 연락처 유형 참조: email-work, email-personal, phone), filters (People Search 엔드포인트와 동일한 매개변수)를 포함합니다. 사용 가능한 필터 매개변수는 인물 검색(People Search)을, 연락처 유형 세부 정보는 Redeem을 참조하세요.

예시:
destination_type
enum<string>

전달 대상 유형입니다.

사용 가능한 옵션:
webhook,
email,
sequences
destination_config
object

대상 구성입니다. 웹훅의 경우: webhook_url (문자열) 필수, headers (객체) 및 body (객체) 선택 사항. 이메일의 경우: email (문자열) 또는 emails (문자열 배열)을 허용합니다. sequences 유형은 sequence_identifier(문자열)와 함께 is_people_search_enrolled / is_company_contact_enrolled 중 최소 하나를 true로 설정해야 합니다.

예시:
frequency_minute
integer
기본값:0

트리거 빈도(분)입니다. 최소: 0, 최대: 10080, 기본값: 0.

필수 범위: 0 <= x <= 10080
max_failure_trigger
integer
기본값:5

모니터 일시 중지 전 최대 연속 실패 횟수입니다. 최소: 1, 최대: 10, 기본값: 5.

필수 범위: 1 <= x <= 10
max_daily_trigger
integer
기본값:500

일일 최대 트리거 수입니다. 최소: 0, 최대: 86400, 기본값: 500.

필수 범위: 0 <= x <= 86400
max_records_per_trigger
integer
기본값:25

트리거당 최대 전달 레코드 수를 제어합니다. 값을 낮추면 전달당 페이로드 크기가 줄어들며, 결과 세트가 크거나 속도 제한이 있는 통합에 권장됩니다. 최소값: 1, 최대값: 100, 기본값: 25. 자세한 내용은 Webhook 설정을 참조하세요.

필수 범위: 1 <= x <= 100
excluded_companies
string[]

이 모니터가 절대 전달하지도 과금하지도 않는 회사(domain_search_id UUID). 두 감지 모드 모두 실행 시점에 보강과 과금 전에 적용되며, companies와 이 목록에 모두 있는 회사는 목록에 있는 동안 제외됩니다. 최대 목록 크기: 100,000(excluded_companies, excluded_domains, excluded_linkedin_urls를 해석한 합계).

예시:
excluded_domains
string[]

제외할 회사 도메인(예: ["existing-client.com"]). 회사로 해석되어 excluded_companies에 병합됩니다.

예시:
excluded_linkedin_urls
string[]

제외할 LinkedIn 회사 URL. 회사로 해석되어 excluded_companies에 병합됩니다.

예시:
record_unit
enum<string>

전달 레코드 1건의 단위: signal(페이로드 signals[], 시그널당 1건) 또는 company(페이로드 companies[], 회사당 1건이며 시그널은 중첩). 기본값은 detection_mode를 따릅니다: signal_first → signal, company_first → company. 상한(max_records_per_trigger, max_daily_records)은 이 단위로 셉니다.

사용 가능한 옵션:
signal,
company
예시:

"company"

company_dedupe_days
integer

같은 회사는 이 일수 안에 최대 한 번의 전달에만 나타납니다(모니터의 모든 시그널 유형에 걸쳐). 기간 안에 전달된 회사는 이후 전달에서 빠지며, 기간 안의 이후 시그널은 대기하지 않고 건너뜁니다. 0 = 끔. 기본값: 0.

필수 범위: x >= 0
예시:

30

is_newest_first
boolean

가장 최신의 일치 시그널을 먼저 전달합니다. 트리거당 또는 일일 상한에서는 최신 레코드가 남고 모니터 커서는 가져온 최신 행까지 이동하므로, 오래된 행은 대기열에 남지 않고 건너뜁니다. 기본값 false(오래된 순, 건너뛰기 없음).

예시:

true

max_daily_records
integer

소유자 시간대 기준 달력일당 전달 레코드 수의 상한(0 = 무제한). 성공한 전달을 모니터의 레코드 단위로 세며, 한 번의 트리거는 남은 예산까지만 전달하고 이후 커서를 옮기지 않고 다음 날까지 기다립니다. 기본값: 0.

필수 범위: x >= 0
예시:

200

notification_email
string<email>

모니터 실패 알림 이메일 주소입니다.

max_retry_per_trigger
integer
기본값:1

트리거당 최대 재시도 횟수입니다. 최소: 0, 최대: 3, 기본값: 1.

필수 범위: 0 <= x <= 3
retry_delay_second
integer
기본값:1

재시도 간 지연 시간(초)입니다. 최소: 1, 최대: 5, 기본값: 1.

필수 범위: 1 <= x <= 5
deep
boolean

선택 사항, query와 함께 사용할 때만 적용됩니다. 정확도를 높이는 리플렉션 패스 실행(기본 true, 해석 지연 약 2배). false로 설정하면 단일 패스로 더 빠르게 해석합니다.

응답

새로 생성된 모니터 세부 정보가 포함된 성공적인 응답입니다.

metadata
object
data
object
마지막 수정일 2026년 8월 28일