> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # 모니터 목록 ���회 > 워크스페이스의 모든 모니터 목록을 조회합니다. ## OpenAPI ````yaml ko-openapi POST /monitors openapi: 3.0.0 info: description: >- Pubrio API는 마켓 확장 인텔리전스를 제공합니다——기업의 신규 시장 진입을 포착하는 실시간 시그널과 그 기반이 되는 기업·인물 데이터. 계정과 연락처를 검색·조회·보강하고, 200+ 시장에 걸친 유형·날짜가 있는 움직임 시그널을 구독하세요. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ko/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ko/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: 워크스페이스 프로필 정보 및 사용량 통계 - name: Enrichment description: 상세한 B2B 데이터로 인물 및 기업 레코드를 보강 - name: Lookalike description: 지정된 기업과 유사한 기업 검색 - name: Search description: 필터를 사용하여 인물, 기업, 채용, 뉴스 및 광고 검색 - name: Lookup description: 특정 인물, 기업, 채용, 뉴스, 광고 및 기술의 상세 정보 조회 - name: LinkedIn description: LinkedIn 프로필 URL을 통한 인물 및 기업 데이터 조회 - name: Redeem description: 크레딧을 사용하여 인물 연락처 정보 잠금 해제 (단건 및 배치) - name: Channels description: 아웃리치 채널 템플릿 관리 (생성, 수정, 삭제, 목록) - name: Monitor description: 웹훅, 통계 및 처리를 포함한 데이터 모니터 생성 및 관리 - name: Filters description: 검색 매개변수에 사용 가능한 필터 값 조회 (기술, 지역, 버티컬 등) - name: API Keys description: API 키의 요청 로그 및 사용량 분석 조회 - name: Insights description: 회사의 신호 집계 인사이트(채용, 뉴스, 광고). - name: Export description: 대량 데이터 내보내기(크레딧 차감). - name: Expansion description: '회사 시장 확장 인텔리전스: 신호, 단계, 시장, 내보내기.' externalDocs: description: >- Pubrio API는 연락처와 계정 정보를 검색, 미리보기, 그리고 보강하는 데 사용됩니다. Pubrio 데이터베이스는 풍부한 B2B 연락처 및 영업 인텔리전스 데이터를 제공합니다. url: https://docs.pubrio.com paths: /monitors: post: tags: - Monitor summary: 모니터 목록 description: 워크스페이스의 모든 모니터 목록을 조회합니다. operationId: monitors_list parameters: [] requestBody: required: true content: application/json: schema: type: object properties: destination_types: type: array items: type: string description: >- 전달 대상 유형으로 필터링합니다 (예: ['email', 'webhook']). 빈 배열은 전체를 반환합니다. detection_modes: type: array items: type: string description: >- 감지 모드로 필터링합니다 (예: ['company_first', 'signal_first']). 빈 배열은 전체를 반환합니다. status: type: string enum: - draft - active - paused - inactive description: 모니터 상태로 필터링합니다. is_ascending_order: type: boolean description: 오름차순으로 정렬합니다. 기본값은 false(내림차순)입니다. default: false order_by: type: string enum: - name - last_trigger_at - last_modified description: >- 정렬 기준 필드입니다. 허용 값: 'name', 'last_trigger_at', 'last_modified'. 생략하면 created_at 내림차순으로 정렬됩니다. search_term: type: string nullable: true description: 모니터 이름만을 대상으로 매칭되는 검색어입니다(정규 표현식, 대소문자 구분 없음). per_page: type: integer description: >- 페이지당 레코드 수입니다. 기본값은 25이며 대부분의 플랜에서 상한이기도 합니다. 이 한도는 구독의 `max_search_per_page`이며 [Profile](/ko/api-reference/endpoint/profile/profile)에서 확인할 수 있습니다. 초과하면 결과가 잘리는 것이 아니라 **HTTP 416**과 코드 `41676`(기업·인물 검색은 `41613`)이 반환됩니다. default: 25 page: type: integer description: >- 페이지 번호이며 1부터 시작합니다. 상한은 구독의 `max_search_page`(기업 검색은 `max_company_search_page`)이며 [Profile](/ko/api-reference/endpoint/profile/profile)에서 확인할 수 있습니다. 초과하면 **HTTP 416**이 반환됩니다. default: 1 responses: '200': description: 페이지네이션된 모니터 목록이 포함된 성공적인 응답입니다. 관심 목록 기반 모니터는 이 목록에서 제외됩니다. content: application/json: schema: type: object properties: data: type: object properties: pagination: type: object properties: page: type: integer description: 현재 페이지 번호입니다. per_page: type: integer description: 페이지당 결과 수입니다. total_entries: type: integer description: 전체 모니터 수입니다. total_pages: type: integer description: 전체 페이지 수입니다. total_display_pages: type: integer description: 전체 표시 페이지 수입니다. is_timeout: type: boolean description: 쿼리 시간 초과 여부입니다. monitors: type: array items: type: object properties: monitor_id: type: string format: uuid description: 모니터의 고유 식별자입니다. name: type: string description: 모니터의 이름입니다. description: type: string description: 모니터의 설명입니다. detection_mode: type: string description: '감지 모드: ''company_first'' 또는 ''signal_first''입니다.' signal_types: type: array items: type: string description: >- 모니터링할 신호 유형입니다 (예: 'jobs', 'news', 'advertisements'). signal_filters: type: object description: 신호에 적용되는 필터입니다. 검색 엔드포인트와 동일한 필터 구조를 사용합니다. company_filters: type: object description: 기업에 적용되는 필터입니다. 검색 엔드포인트와 동일한 필터 구조를 사용합니다. companies: type: array items: type: string description: 모니터링할 도메인 검색 식별자 배열입니다. is_company_enrichment: type: boolean description: 결과에서 기업 데이터를 보강할지 여부입니다. is_people_enrichment: type: boolean description: 결과에서 인물 데이터를 보강할지 여부입니다. people_enrichment_configs: type: object description: 필터 및 제한을 포함한 인물 보강 구성입니다. properties: max_people_to_return: type: integer description: '기업당 반환할 최대 인물 수입니다. 최소: 1, 최대: 25.' destination_type: type: string description: '전달 대상 유형입니다 (예: ''email'', ''webhook'').' destination_config: type: object description: '전달 대상 구성입니다 (예: 웹훅 URL, 이메일 주소).' frequency_minute: type: integer description: '트리거 빈도(분)입니다. 최소: 0, 최대: 10080, 기본값: 0.' max_retry_per_trigger: type: integer description: '트리거당 최대 재시도 횟수입니다. 최소: 0, 최대: 3, 기본값: 1.' max_records_per_trigger: type: integer description: '트리거당 최대 레코드 수입니다. 최소: 1, 최대: 100, 기본값: 25.' retry_delay_second: type: integer description: '재시도 간 지연 시간(초)입니다. 최소: 1, 최대: 5, 기본값: 1.' max_daily_trigger: type: integer description: '일일 최대 트리거 수입니다. 최소: 0, 최대: 86400, 기본값: 500.' max_failure_trigger: type: integer description: '일시 중지 전 최대 연속 실패 횟수입니다. 최소: 1, 최대: 10, 기본값: 5.' masked_signature: type: string description: 표시용 마스킹된 웹훅 서명입니다. status: type: string enum: - draft - active - paused - inactive description: 모니터의 라이프사이클 상태입니다. notification_email: type: string description: 모니터 알림 이메일 주소입니다. repeated_failure_count: type: integer description: 현재 연속 실패 횟수입니다. last_trigger_at: type: string format: date-time nullable: true description: 마지막 트리거 타임스탬프입니다. last_processed_at: type: string format: date-time nullable: true description: 마지막 처리 완료 타임스탬프입니다. created_at: type: string format: date-time description: 모니터 생성 타임스탬프입니다. last_modified: type: string format: date-time description: 모니터 최종 수정 타임스탬프입니다. user: type: object properties: user_id: type: string description: 모니터를 생성한 사용자의 식별자입니다. nickname: type: string description: 사용자의 표시 이름입니다. email: type: string description: 사용자의 이메일입니다. description: 모니터를 생성한 사용자입니다. total_trigger_today: type: integer description: 오늘 실행된 트리거 수입니다. success_rate: type: string nullable: true description: >- 전체 성공률 (0~1)을 소수점 문자열로 나타낸 값입니다 (예: "0.983"). 모니터가 한 번도 트리거되지 않은 경우 null입니다. example: data: pagination: page: 1 per_page: 25 total_entries: 8 total_pages: 1 total_display_pages: 1 is_timeout: false monitors: - monitor_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 name: Company First Monitor description: null detection_mode: company_first signal_types: - jobs - news - advertisements signal_filters: - filters: locations: - US signal_type: jobs - filters: locations: - US signal_type: news - filters: target_locations: - US signal_type: advertisements company_filters: locations: - US companies: - 67c4696b-b7b0-46b5-b2af-9f434543661e is_company_enrichment: true is_people_enrichment: true people_enrichment_configs: - filters: people_locations: - US max_people_to_return: 3 people_contact_types: - email-work destination_type: webhook destination_config: webhook_url: https://usewebhook.com/example headers: X-Custom-Auth: your-token body: source: pubrio notification_email: team@example.com max_retry_per_trigger: 1 retry_delay_second: 1 max_records_per_trigger: 25 max_daily_trigger: 500 frequency_minute: 0 status: active max_failure_trigger: 5 repeated_failure_count: 0 last_trigger_at: '2026-04-05T22:29:36.349Z' last_processed_at: '2026-04-05T18:28:05.715Z' masked_signature: 9••••••••••••••••f09 created_at: '2026-04-03T18:49:20.048Z' last_modified: '2026-04-05T22:29:36.349Z' user: user_id: a1b2c3d4-0000-0000-0000-000000000000 nickname: Jane Smith email: jane@example.com total_trigger_today: 4 success_rate: '1.000' - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: responses: general_error: description: 잘못된 요청. 요청 형식이 올바르지 않거나 잘못된 매개변수가 포함되어 있습니다. 오류 코드와 메시지를 확인하세요. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: 오류 코드 및 메시지는 상황에 따라 다를 수 있습니다. 자세한 내용은 문서를 참조하세요. type: string details: type: object rate_limit_error: description: 요청 속도 제한 초과. 주어진 시간 내에 너무 많은 요청이 전송되었습니다. 속도 제한 창이 재설정된 후 다시 시도하세요. content: application/json: schema: required: - error type: object properties: error: example: 요청 빈도가 제한을 초과했습니다. 잠시 후 다시 시도해주세요. type: string server_error: description: 내부 서버 오류. 서버에서 예기치 않은 오류가 발생했습니다. 오류가 지속되면 지원팀에 문의하세요. content: application/json: schema: required: - error type: object properties: error: example: 요청을 처리하는 중 서버에서 예기치 않은 오류가 발생했습니다 type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- API에서 수행하는 작업 및 해당 권한을 식별하는 고유한 API 토큰입니다. 이 토큰은 [설정](https://dashboard.pubrio.com/#/settings/) 섹션에서 생성할 수 있습니다. in: header ````