> ## 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. # モニター作成 > データモニターを作成します。指定した企業とフィルターを対象に、注目すべきビジネスシグナル（新しい求人、ニュース、広告、市場拡大の動き）を常時検出し、各マッチに企業情報や担当者データを付加して、設定したスケジュールで送信先（メールまたは Webhook）へ配信する、常時稼働の監視です。項目ごとに設定することも、`query` に自然言語の一文を渡してモニター全体を記述し、同一リクエスト内で設定へ解釈させることもできます。 ## OpenAPI ````yaml jp-openapi POST /monitors/create openapi: 3.0.0 info: description: >- Pubrio API はマーケット拡大インテリジェンスを提供します——企業の新市場参入を捉えるリアルタイムシグナルと、その基盤となる企業・人物データ。アカウントやコンタクトの検索・ルックアップ・エンリッチメントに加え、200+ 市場にわたる種別・日付付きの動きシグナルを購読できます。 version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ja/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ja/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: Webhook、統計、処理を含むデータモニターの作成と管理 - 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/create: post: tags: - Monitor summary: モニターの作成 description: >- データモニターを作成します。指定した企業とフィルターを対象に、注目すべきビジネスシグナル（新しい求人、ニュース、広告、市場拡大の動き）を常時検出し、各マッチに企業情報や担当者データを付加して、設定したスケジュールで送信先（メールまたは Webhook）へ配信する、常時稼働の監視です。項目ごとに設定することも、`query` に自然言語の一文を渡してモニター全体を記述し、同一リクエスト内で設定へ解釈させることもできます。 operationId: monitors_create parameters: [] requestBody: required: true content: application/json: schema: type: object properties: name: type: string description: モニターの名前。 description: type: string description: モニターの説明。 status: type: string description: >- モニターを作成する際のライフサイクル状態。既定は `active`。`draft` を使うと未完成のモニターを保存できます（必須は `name` のみ、検証は有効化時まで延期され、下書きは実行されません）。 enum: - draft - active - paused - inactive default: active detection_mode: type: string description: >- シグナルの検出方法。`signal_first` は市場全体を広くスキャンし、`company_first` は指定した企業リストを追跡します（企業・ドメイン・LinkedIn URL のいずれかが 1 件以上必要）。**作成後は変更できません** — 既存モニターで変更すると `40021` が返ります。新しいモニターを作成してください。 enum: - company_first - signal_first signal_types: type: array items: type: string enum: - jobs - news - advertisements - expansions - cloud_footprints description: 監視対象のシグナルタイプ。 signal_filters: type: array items: type: object required: - signal_type properties: signal_type: type: string enum: - jobs - news - advertisements - expansions - cloud_footprints description: このエントリが絞り込む対象のストリーム。 filters: type: object description: >- このストリームのフィルタ。`jobs`、`news`、`advertisements` は [Job Search](/jp/api-reference/endpoint/companies/job_search)、[News Search](/jp/api-reference/endpoint/companies/news_search)、[Advertisement Search](/jp/api-reference/endpoint/companies/advertisements_search) のパラメータを使います。`expansions` は [Expansion Search](/jp/api-reference/endpoint/expansions/market_lookup) の語彙を使います：`froms` / `tos`、`window_days`、`stages`、`scopes`、`momentum`、`freshness`、`signal_types`、`signal_subtypes`、`signal_strengths`、`source_types`。スラッグは [Expansion Reference](/jp/api-reference/endpoint/expansions/types) で解決します。 description: モニターが監視するシグナルストリームごとに 1 件。 example: - signal_type: jobs filters: locations: - US - signal_type: news filters: locations: - US - signal_type: advertisements filters: target_locations: - US - signal_type: expansions filters: tos: - US stages: - expanding - scaling signal_types: - HIRE - EXEC signal_strengths: - high - very_high company_filters: type: object description: >- グローバル企業フィルター（第2レイヤーとしてすべてのシグナルタイプに適用）。[Company Search](/jp/api-reference/endpoint/companies/search)エンドポイントと同じパラメータ（locations、employees、technologies、verticals など）を受け付けます。利用可能なフィルターの完全なリストについては Company Search を参照してください。 example: locations: - US employees: - - 501 - 1000 - - 1001 - 5000 companies: type: array items: type: string format: uuid description: >- 監視対象の企業 domain_search_id UUID のリスト。主に company_first モードでターゲット企業を指定するために使用されます。`domains` または `linkedin_urls` を代替として使用することもできます — いずれか1つのみ必要です。 domains: type: array items: type: string description: >- 監視対象の企業ドメインリスト（例: ["openai.com", "google.com"]）。`companies` の代替として使用できます — Pubrio が対応する企業を自動的に解決します。`companies`、`domains`、`linkedin_urls` のいずれか1つを指定してください。 linkedin_urls: type: array items: type: string format: uri description: >- LinkedInの企業ページURLリスト（例: ["https://linkedin.com/company/pubrio"]）。`companies` の代替として使用できます。いずれか1つを指定してください。 is_company_enrichment: type: boolean description: 結果の企業データをエンリッチメントするかどうか。 is_people_enrichment: type: boolean description: 結果の人物データをエンリッチメントするかどうか。 people_enrichment_configs: type: array items: type: object description: >- 人物エンリッチメントレイヤーの配列。各レイヤーは独立した人物検索を実行します。`max_people_to_return`（1-25）、`people_contact_types`（配列 — [Redeem](/jp/api-reference/endpoint/redeem/people) エンドポイントの連絡先タイプ: email-work、email-personal、phone を参照）、`filters`（[People Search](/jp/api-reference/endpoint/people/search) エンドポイントと同じパラメータ）を含みます。利用可能なフィルターパラメータについては People Search を、連絡先タイプの詳細については Redeem を参照してください。 example: - filters: people_locations: - US max_people_to_return: 3 people_contact_types: - email-work destination_type: type: string description: 配信先タイプ。 enum: - webhook - email - sequences destination_config: type: object description: >- 配信先の設定。Webhookの場合：`webhook_url`（文字列）が必須、`headers`（オブジェクト）と `body`（オブジェクト）はオプション。メールの場合：`email`（文字列）または `emails`（文字列の配列）を指定できます。sequences タイプは `sequence_identifier`（文字列）に加えて、`is_people_search_enrolled` / `is_company_contact_enrolled` の少なくとも一方を true に設定する必要があります。 frequency_minute: type: integer description: トリガー頻度（分単位）。最小：0、最大：10080、デフォルト：0。 minimum: 0 maximum: 10080 default: 0 max_failure_trigger: type: integer description: モニター一時停止前の最大連続失敗数。最小：1、最大：10、デフォルト：5。 minimum: 1 maximum: 10 default: 5 max_daily_trigger: type: integer description: 1日あたりの最大トリガー数。最小：0、最大：86400、デフォルト：500。 minimum: 0 maximum: 86400 default: 500 max_records_per_trigger: type: integer description: >- トリガーごとに配信される最大レコード数を制御します。値を低く設定すると1回あたりのペイロードサイズが削減され、大量の結果セットやレート制限のある統合に推奨されます。最小値：1、最大値：100、デフォルト：25。詳細については [Webhook の設定](/jp/developer-guides/setting-up-webhooks) をご覧ください。 minimum: 1 maximum: 100 default: 25 excluded_companies: type: array items: type: string description: >- このモニターが配信も課金も行わない企業（`domain_search_id` UUID）。両方の検出モードで実行時に、エンリッチメントと課金の前に適用されます。`companies` とこのリストの両方にある企業は、リストにある間は除外されます。上限：100,000 件（`excluded_companies`・`excluded_domains`・`excluded_linkedin_urls` の解決後の合計）。 example: - 550e8400-e29b-41d4-a716-446655440002 excluded_domains: type: array items: type: string description: >- 除外する企業ドメイン（例：["existing-client.com"]）。企業に解決され `excluded_companies` に統合されます。 example: - existing-client.com excluded_linkedin_urls: type: array items: type: string description: 除外する LinkedIn 企業 URL。企業に解決され `excluded_companies` に統合されます。 example: - https://linkedin.com/company/existing-client record_unit: type: string enum: - signal - company description: >- 配信レコード 1 件の単位：`signal`（ペイロードは `signals[]`、シグナルごとに 1 件）または `company`（ペイロードは `companies[]`、企業ごとに 1 件でシグナルをネスト）。デフォルトは `detection_mode` に従います：`signal_first` → `signal`、`company_first` → `company`。各上限（`max_records_per_trigger`、`max_daily_records`）はこの単位で数えます。 example: company company_dedupe_days: type: integer minimum: 0 description: >- 同じ企業はこの日数内に最大 1 回の配信にしか現れません（モニターの全シグナルタイプ横断）。ウィンドウ内に配信済みの企業は以降の配信から外れ、ウィンドウ内のその後のシグナルは待機せずスキップされます。`0` = オフ。デフォルト：0。 example: 30 is_newest_first: type: boolean description: >- 一致したシグナルのうち最新のものから配信します。トリガー毎または日次の上限では最新のレコードが残り、モニターのカーソルは取得した最新行まで進むため、古い行はキューされずスキップされます。デフォルト `false`（古い順、スキップなし）。 example: true max_daily_records: type: integer minimum: 0 description: >- 所有者のタイムゾーンの暦日あたりに配信するレコード数の上限（`0` = 無制限）。成功した配信をモニターのレコード単位で数え、1 回のトリガーは残り分までしか配信せず、その後はカーソルを進めずに翌日まで待ちます。デフォルト：0。 example: 200 notification_email: type: string format: email description: モニター失敗通知用のメールアドレス。 max_retry_per_trigger: type: integer description: トリガーあたりの最大リトライ回数。最小：0、最大：3、デフォルト：1。 minimum: 0 maximum: 3 default: 1 retry_delay_second: type: integer description: リトライ間の遅延（秒単位）。最小：1、最大：5、デフォルト：1。 minimum: 1 maximum: 5 default: 1 query: type: string maxLength: 2000 description: >- モニターの自然言語による説明（任意の言語）。例:「日本に進出する企業を監視し、C レベルの人物の勤務先メールを取得して、me@company.com にリアルタイムでアラートを送る」。同一リクエスト内で下記のフィールド（detection_mode、signal_types、signal_filters、people_enrichment_configs、destination_type/destination_config、frequency_minute）に解析されます。明示的に渡したフィールドは解析結果より優先されます。テキストがモニターのリクエストでない場合は 400 を返します。最大 2000 文字。 deep: type: boolean description: >- 任意。`query` と併用する場合のみ有効。精度向上のためにリフレクション処理を実行（既定 true。解析のレイテンシは約 2 倍）。false にすると単一パスで高速に解析します。 anyOf: - title: 自然言語 required: - query - title: 構造化フィールド required: - name - detection_mode - signal_types - destination_type - destination_config - title: 下書き required: - name - status responses: '200': description: 新規作成されたモニターの詳細を含む成功レスポンスです。 content: application/json: schema: type: object properties: metadata: type: object properties: unresolved: type: object description: >- このリクエストで送った各リストのうち、どの企業にも解決できなかった入力（送らなかったリストは `null`）。修正または削除してください。モニターは解決できた企業で保存済みです。 properties: companies: type: object nullable: true properties: domains: type: array items: type: string linkedin_urls: type: array items: type: string excluded_companies: type: object nullable: true properties: domains: type: array items: type: string linkedin_urls: type: array items: type: string data: 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: このモニターが監視するシグナル種別。 signal_filters: type: array items: type: object description: >- シグナル種別ごとの保存済みフィルター。`query` で作成した場合、入力した文がどう解釈されたかがここに表示されます。意図どおりか確認してください。 company_filters: type: object description: 一致した各シグナルに適用される企業プロフィールのフィルター。 company_count: type: integer is_company_enrichment: type: boolean description: 一致結果に企業詳細を付加するかどうか。 is_people_enrichment: type: boolean description: 一致結果に人物と連絡先を付加するかどうか。 people_enrichment_configs: type: array items: type: object description: 保存済みの人物エンリッチメント設定。 destination_type: type: string description: 配信先タイプ。 destination_config: type: object description: 配信先の詳細（メールまたは webhook URL）。 frequency_minute: type: integer description: モニターの実行間隔（分）。 notification_email: type: string nullable: true description: モニター自体の通知を受け取るアドレス。 max_retry_per_trigger: type: integer description: 1 回のトリガーで許可される再試行回数。 retry_delay_second: type: integer description: 再試行の間隔（秒）。 max_records_per_trigger: type: integer description: 1 回のトリガーで配信される最大レコード数。 max_daily_trigger: type: integer description: 1 日あたりの最大トリガー回数。 max_failure_trigger: type: integer description: モニターが停止するまでの連続失敗回数。 excluded_company_count: type: integer record_unit: type: string nullable: true enum: - signal - company company_dedupe_days: type: integer max_daily_records: type: integer is_newest_first: type: boolean status: type: string enum: - draft - active - paused - inactive description: モニター作成時のライフサイクル状態。 masked_signature: type: string description: 表示用のマスクされたWebhook署名。 created_at: type: string format: date-time description: モニターが作成されたタイムスタンプ。 signature: type: string format: uuid description: ペイロード検証用のWebhook署名。作成時にのみ返されます。 example: data: monitor_id: c9cd5421-b327-4243-9cd7-8b341b3da8bd name: Expansion signals → JP description: null detection_mode: signal_first signal_types: - expansions signal_filters: - signal_type: expansions filters: tos: - JP company_filters: {} company_count: 0 is_company_enrichment: false is_people_enrichment: true people_enrichment_configs: - max_people_to_return: 5 filters: management_levels: - c_suite people_contact_types: - email-work destination_type: email destination_config: emails: - me@company.com frequency_minute: 5 notification_email: null max_retry_per_trigger: 3 retry_delay_second: 60 max_records_per_trigger: 100 max_daily_trigger: 24 max_failure_trigger: 5 excluded_company_count: 0 record_unit: null company_dedupe_days: 0 max_daily_records: 0 is_newest_first: false status: active masked_signature: 5••••••••••••••8b8 created_at: '2026-07-16T10:27:40.469Z' signature: 52209a0d-f1c8-4111-a685-ac86edc678b8 '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: レスポンスボディには `error` フィールドが含まれ、問題の概要がメッセージとして記載されます。 type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- API で実行する操作内容と、その操作に付与された権限を識別するための一意の API トークンです。このトークンはダッシュボードの [設定](https://dashboard.pubrio.com/#/settings/) 画面から発行できます。 in: header ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.