RISK EYES V2 Web記事 記事数表示API

API情報

説明: RISK EYES V2 Web記事 記事数表示API 仕様書

バージョン: 1.0.0

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

公開日: 2025年7月14日

概要

本機能は、APIで反社チェック対象の記事数を返却します。

システム上に、記事数を表示・記録できるよう開発いただくことにより、反社チェック対象の記事の有無・記事数をシステム内で確認することが可能になります。

処理概要

調査対象となる「法人名」「人名(代表者名など)」などの検索条件を指定し、会員ページに事前に設定してあるネガティブワードとの複合条件で検索した、従来は本サービスの会員ページ内で表示される『記事数』を本APIにより出力します。

記事がヒットした取引先に関する記事は会員ページでも検索できます。

注意事項

並行でリクエストを送信せず、1件ずつリクエストを送信してください。

認証

このAPIはBearer認証を使用します。

/api/v2/tokenで取得したアクセストークンを使用してください。

Authorization: Bearer <ACCESS_TOKEN>

エンドポイント

POST /api/v2/search/count/web2

概要: Web記事 記事数表示

説明: Web記事検索の記事数を表示します

Web Search Count

リクエストパラメータ

パラメータ名 型 必須 説明 例
keyword string 必須 検索キーワード "ソーシャルワイヤー"
negative_type integer 任意 ネガティブワード種別 (0-3, デフォルト: 0) 0
limit array[string] 任意 絞込ワード（AND条件） ["不祥事", "問題"]
limit_or array[string] 任意 絞込ワード（OR条件） ["事故", "トラブル"]
keyword_not array[string] 任意 除外ワード（手動指定） ["無関係", "関係なし"]
keyword_not_flg boolean 任意 除外ワード自動抽出フラグ (デフォルト: false) false
time_period_01 string (date-time) 任意 掲載期間（開始日）YYYY/MM/DD または YYYY-MM-DD "2024/01/01"
time_period_02 string (date-time) 任意 掲載期間（終了日）YYYY/MM/DD または YYYY-MM-DD "2024/12/31"
createdate_start string (date-time) 任意 記事登録日（開始日）YYYY/MM/DD または YYYY-MM-DD "2024/01/01"
ai_negative_score_threshold_level integer 任意 AI絞込レベル (0: 絞込なし, 1: 10%以上, 2: 20%以上, 4: 40%以上) 0
entity_refinement boolean 任意 AIキーワードフィルター (デフォルト: false) false
negative_category_filter array[string] 任意 ネガティブ分類の絞込 ["反社", "背任"]
concern_level_select integer 任意 懸念レベル 0:指定なし 1:レベル1(懸念i,ii,iii) 2:レベル2(懸念ii,iii) 3:レベル3(懸念iii) 1
administrative_penalty boolean 任意 行政情報 true
client_customer_id integer 任意 取引先管理番号 123
remark string 任意 備考 "検索メモ"
condition_id integer 任意 検索条件ID 123
strip_corps boolean 任意 法人格除去フラグ（法人名を除去する場合はtrueを指定、デフォルト: false） false

リクエスト例

基本的な検索
{ "keyword": "ソーシャルワイヤー" }
詳細検索
{ "keyword": "ソーシャルワイヤー", "negative_type": 1, "limit": ["不祥事"], "time_period_01": "2024/01/01", "time_period_02": "2024/12/31", "concern_level_select": 2, "administrative_penalty": true }

レスポンス

200検索結果件数取得成功

説明: 検索結果件数取得成功

レスポンススキーマ
フィールド名 型 説明
count integer 検索結果件数
レスポンス例
成功レスポンス:
{ "count": 123 }
結果なし:
{ "count": 0 }
400リクエストエラー

説明: リクエストエラー

レスポンススキーマ
フィールド名 型 説明
status integer HTTPステータスコード
result object (nullable) 結果データ（エラー時はnull）
errors object エラー情報
errors.message string エラーメッセージ
errors.error_code string エラーコード
エラー例
不正なリクエスト:
{ "status": 400, "result": null, "errors": { "message": "不正なリクエストです。パラメータを確認してください。", "error_code": "E400000" } }
キーワード未設定:
{ "status": 400, "result": null, "errors": { "message": "{調査キーワード}は必須です。", "error_code": "E400002" } }
案件未設定:
{ "status": 400, "result": null, "errors": { "message": "{案件}が設定されていません。", "error_code": "E400003" } }
ネガティブキーワード未設定:
{ "status": 400, "result": null, "errors": { "message": "{ネガティブキーワード}が設定されていません。", "error_code": "E400003" } }
DBタイプ未設定:
{ "status": 400, "result": null, "errors": { "message": "{DBタイプ}が設定されていません。", "error_code": "E400003" } }
無効なネガティブワードタイプ:
{ "status": 400, "result": null, "errors": { "message": "{ネガティブワードタイプ}に無効な値が設定されています。", "error_code": "E400004" } }
禁止文字使用:
{ "status": 400, "result": null, "errors": { "message": "{各パラメータ}に使用できない文字が含まれています。", "error_code": "E400005" } }
401認証エラー

説明: 認証エラー

レスポンススキーマ
フィールド名 型 説明
status integer HTTPステータスコード
message string エラーメッセージ
エラー例
{ "status": 401, "message": "トークンの有効期限が切れています。" }
500サーバーエラー

説明: サーバーエラー

レスポンススキーマ
フィールド名 型 説明
status integer HTTPステータスコード
result object (nullable) 結果データ（エラー時はnull）
errors object エラー情報
errors.message string エラーメッセージ
errors.error_code string エラーコード
エラー例
システムエラー:
{ "status": 500, "result": null, "errors": { "message": "システムでエラーが発生しました。", "error_code": "E500000" } }
記事数取得エラー:
{ "status": 500, "result": null, "errors": { "message": "記事数の取得中にエラーが発生しました。", "error_code": "E500001" } }
検索結果過多エラー:
{ "status": 500, "result": null, "errors": { "message": "検索結果の件数が多すぎます。詳細条件を指定して再検索ください。", "error_code": "E500003" } }

エラーコード一覧

エラーコード HTTPステータス 説明
E400000 400 不正なリクエストです。パラメータを確認してください。
E400002 400 {調査キーワード}は必須です。
E400003 400 {案件}が設定されていません。
E400003 400 {ネガティブキーワード}が設定されていません。
E400003 400 {DBタイプ}が設定されていません。
E400004 400 {ネガティブワードタイプ}に無効な値が設定されています。
E400005 400 {各パラメータ}に使用できない文字が含まれています。
E500000 500 システムでエラーが発生しました。
E500001 500 記事数の取得中にエラーが発生しました。
E500003 500 検索結果の件数が多すぎます。詳細条件を指定して再検索ください。

公開履歴

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