RISK EYES V2 リクエストURL機能

機能概要

説明: RISK EYES V2 リクエストURL機能 仕様書

バージョン: 1.0.0

サーバー: https://www.riskeyes.jp

サポート: support@riskeyes.jp

公開日: 2025年7月14日

機能の目的

リクエストURL機能は、URLパラメータを通じて検索条件を指定し、自動的にリアルタイム検索を実行する機能です。 この機能により、以下のことが可能になります:

処理概要

URLパラメータで指定された検索条件を自動的に検索フォームに設定し、リアルタイム検索を実行いたします。 検索条件にエラーがある場合は、エラーメッセージを表示し、検索フォームは表示されません。

認証

このURLアクセスには認証が必要です。

URLパラメータにアクセストークンを含める必要がございます。

/requestUrl?access_token=<ACCESS_TOKEN>&keyword=企業名&webv2=true

アクセス方法

GET /requestUrl

概要: URLパラメータによる検索条件指定と自動検索実行

説明: URLパラメータで検索条件を指定し、自動的にリアルタイム検索を実行いたします

Request URL Search

URLパラメータ

必須パラメータ
パラメータ名 必須 説明
keyword string 必須 検索キーワード keyword=企業名
access_token string 必須 アクセストークン access_token=eyJhb...
検索対象メディア(少なくとも1つは必須)
パラメータ名 必須 説明 デフォルト
paper boolean 任意 新聞検索の有効/無効 false paper=true
webv2 boolean 任意 Web検索の有効/無効 false webv2=true
blogv2 boolean 任意 ブログ検索の有効/無効 false blogv2=true
overseas boolean 任意 海外検索の有効/無効 false overseas=true
database boolean 任意 反社データベース検索の有効/無効 false database=true
検索条件パラメータ

注意: 以下のパラメータは、選択した検索対象メディアによって使用可否が異なります。

パラメータ名 必須 説明 対応メディア
negative_type number 任意 ネガティブタイプ 新聞、Web、ブログ negative_type=1
limit string 任意 AND検索キーワード (limit_orとは併用不可) 新聞、Web、ブログ limit=東京,大阪
limit_or string 任意 OR検索キーワード (limitとは併用不可) 新聞、Web、ブログ limit_or=関東,関西
keyword_not string 任意 除外キーワード 新聞、Web、ブログ keyword_not=除外語,除外語2
negative_category_filter string 任意 ネガティブカテゴリフィルタ 新聞、Web、ブログ negative_category_filter=反社,背任
time_period_01 string 任意 検索期間開始日(ISO 8601形式) 新聞、Web、ブログ、反社DB time_period_01=2024-01-01
time_period_02 string 任意 検索期間終了日(ISO 8601形式) 新聞、Web、ブログ、反社DB time_period_02=2024-12-31
createdate_start string 任意 記事登録日(開始日)(ISO 8601形式) 新聞、Web、ブログ、反社DB createdate_start=2024-01-01
birth_from number 任意 生年月日範囲開始 新聞 birth_from=1980
birth_to number 任意 生年月日範囲終了 新聞 birth_to=1990
administrative_penalty boolean 任意 行政処分検索の有効/無効 Web administrative_penalty=true
ai_negative_score_threshold_level number 任意 AIネガティブスコア閾値レベル(0, 1, 2, 4) Web ai_negative_score_threshold_level=2
entity_refinement boolean 任意 エンティティ絞り込みの有効/無効 Web entity_refinement=true
concern_level_select number 任意 懸念レベル選択(0-3) 新聞、Web concern_level_select=2
keyword_en string 任意 英語キーワード(空白区切り) 海外 keyword_en=company corporation
keyword_not_flg boolean 任意 除外キーワード自動取得の有効/無効 新聞、Web、ブログ keyword_not_flg=true
strip_corps boolean 任意 法人格除去フラグ(デフォルト: false) 新聞、Web、ブログ、海外、反社DB strip_corps=true
client_customer_id number 任意 取引先管理番号 新聞、Web、ブログ、海外、反社DB client_customer_id=123
remark string 任意 備考 新聞、Web、ブログ、海外、反社DB remark=検索メモ
メディア別パラメータ対応表
パラメータ名 新聞
(paper)
Web
(webv2)
ブログ
(blogv2)
反社DB
(database)
海外
(overseas)
negative_type
limit
limit_or
keyword_not
negative_category_filter
time_period_01
time_period_02
createdate_start
birth_from
birth_to
administrative_penalty
ai_negative_score_threshold_level
entity_refinement
concern_level_select
keyword_en
keyword_not_flg
strip_corps
client_customer_id
remark
保存検索条件パラメータ
パラメータ名 必須 説明
condition_id number 任意 保存された検索条件のID condition_id=123

使用例

基本的な検索
新聞とWeb検索を有効にした基本検索:
/requestUrl?access_token=eyJhb...&keyword=企業名&webv2=true&paper=true
詳細条件付き検索
詳細条件を指定した検索:
/requestUrl?access_token=eyJhb...&keyword=企業名&webv2=true&paper=true&negative_type=1&time_period_01=2024-01-01&time_period_02=2024-12-31&limit=東京&keyword_not=除外語

レスポンス

成功時の動作

  • 検索条件フォームが表示されます
  • 指定された条件で自動的に検索が実行されます
  • 検索結果が表示されます

エラー時の動作

  • エラーメッセージが表示されます
  • 検索フォームは表示されません
エラーメッセージの種類
  • 必須項目エラー: "必須項目です"
  • 型エラー: "無効な値です。[型名]型である必要があります"
  • 値エラー: "無効な値です"
  • カスタムエラー: パラメータ固有のエラーメッセージ

バリデーション

必須項目チェック

セキュリティ考慮事項

認証

アクセス制御

制限事項

利用制限

  1. メディアタイプ制限: ユーザーの契約プランに応じて利用可能なメディアタイプが制限されます
  2. 検索条件制限: 一部の検索条件は特定の権限が必要です
  3. パラメータ長制限: URLの長さ制限により、非常に長いパラメータは使用できない場合があります
  4. アクセストークンについて RISK EYESの旧APIで出力されたトークンは利用できないのでご注意ください

公開履歴

バージョン 公開日 変更内容
1.0.0 2025年7月14日 初版公開