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
signal_filters
object[]

신호 필터 객체 배열입니다. 각 객체는 signal_type (jobs, news, advertisements, expansions 중 하나)과 filters (신호별 매개변수가 포함된 객체)로 구성됩니다. 신호 유형별 사용 가능한 필터 매개변수는 Job Search, News Search, Advertisement Search를 참조하세요. expansions의 경우 Expansion Search의 필터 어휘(froms / tos, stages, momentum, freshness, scopes, signal_types, signal_strengths, window_days)를 사용합니다.

예시:
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
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로 설정하면 단일 패스로 더 빠르게 해석합니다.

응답

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

data
object