IPジオロケーション、メールチェック、ログインリスクシグナルをひとつのAPIで。
ブラウザからサイト訪問者の位置を特定し、バックエンドからIPアドレスを検索し、登録メールの使い捨てドメインや入力ミスを見つけ、ログイン時の不可能な移動を検知できます。すべてひとつのプランとひとつの月間リクエスト枠で利用可能です。カードはこのページリクエストのエッジデータとローカル補完のプレビューであり、APIレスポンスではありません。
request.cf216.73.216.231
- 座標
- 39.9612, -82.9988
- タイムゾーン
- America/New_York
- 郵便番号
- 43215
- 大陸
- NA
- ネットワーク
- Anthropic, PBC
- ASN
- AS16509
- 通貨
- $ USD
- 国番号
- +1
- 日の出/日の入り
- 7:49 / 18:42
- デバイス
- —
- セキュリティ
- 利用不可—未チェック
用途に合ったAPIを選ぶ
ウェブサイト上で訪問者の位置を特定する
許可されたオリジンに制限された公開可能キーを使い、ブラウザから直接訪問者ジオロケーションAPIを呼び出します。おおよその国・都市データ、タイムゾーン、利用可能な地域情報を使って、より関連性の高い体験を提案できます。
訪問者ジオロケーションを見る →バックエンドからIPをルックアップする
アプリケーションに既にIPアドレスがありますか?サーバーからIPルックアップエンドポイントに送信してください。シークレットキーでリクエストを認証し、レスポンスにはサードパーティのIPジオロケーションデータベースの位置情報フィールドが含まれます。
IPルックアップAPIを見る →IPアドレスのリストを処理する
1回のバッチリクエストで最大100件のIPアドレスを送信し、レポート作成やエンリッチメント、その他のバックエンド処理のために順序付きのルックアップ結果を受け取れます。ルックアップの利用量はバッチ単位ではなく、IPごとに計測されます。
IP一括ルックアップを見る →登録時にメールアドレスをチェック
構文、既知の使い捨てドメイン、ドメインにメールサーバーがあるか、入力ミスの可能性、ロールアドレスをチェックし、理由付きで受け入れ・要確認・拒否の判定を返します。公開可能キーでフォームから呼び出すことも、バックエンドやダッシュボードから1リクエストあたり最大100件、またはリストで最大100,000件をチェックすることもできます。
メールチェックを見る →新規登録を1回の呼び出しでスコアリング
POST /v1/signup/check は、メールチェックと、登録元IPの国・ネットワーク、プランに応じたVPN・Tor・データセンター指標、メールドメインの経過年数を組み合わせ、0〜100のスコアと理由付きの判定を返します。スコアは判断材料であり、不正の証明ではありません。
登録不正対策のワークフローを見る →ログイン時の不可能な移動を検知
POST /v1/risk/check は、ログインIPのおおよその位置をユーザーの前回保存された位置と比較し、距離、経過時間、推定速度、リスクレベルを返します。誤検知が起こる可能性があり、アカウント乗っ取りを証明するものではありません。
不可能な移動の検知を見る →ブラウザ統合の例とエッジプレビュー
この例は、ブラウザからGET /v1/geoを呼び出す方法を示しています。このプレビューを生成するために実際に実行されたものではありません。位置情報はこのページリクエストから取得され、エンリッチメントはローカルで導出されます。欠落した値は利用できないことを意味し、セキュリティチェックは実行されていません。
リクエスト例—実行されていません
import { WatchIP } from "@digitload/watch-ip-sdk";
const client = new WatchIP("wip_pub_xxxxxxxx");
const { country, city, timezone, currency, callingCode } = await client.getGeo();ページリクエストのプレビュー—APIレスポンスではありません
{
"ip": "216.73.216.231",
"country": "US",
"region": "Ohio",
"regionCode": "OH",
"city": "Columbus",
"postalCode": "43215",
"latitude": 39.96118,
"longitude": -82.99879,
"continent": "NA",
"timezone": "America/New_York",
"isEUCountry": false,
"asn": 16509,
"asOrganization": "Anthropic, PBC",
"currency": {
"code": "USD",
"name": "US Dollar",
"symbol": "$"
},
"callingCode": "+1",
"compliance": {
"isGDPR": false,
"usPrivacyLaw": null,
"isLGPD": false,
"requiresCookieConsent": false,
"dataResidencyZone": "US",
"isEmbargoedCountry": false
},
"locale": {
"suggestedLocale": "en-US",
"measurementSystem": "imperial",
"firstDayOfWeek": 0,
"dateFormat": "MM/DD/YYYY"
},
"sun": {
"sunrise": "2026-10-23T11:49:40.834Z",
"sunset": "2026-10-23T22:42:44.749Z"
},
"holiday": {
"isPublicHolidayToday": false,
"todayHolidayName": null,
"nextHoliday": {
"date": "2026-11-11",
"name": "Veterans Day"
}
},
"age": {
"ageOfMajority": 18,
"drinkingAge": 21,
"adultContentVerificationRequired": true,
"jurisdictionNote": "HB 96 (2025)"
},
"tax": {
"jurisdictionCode": "US-OH",
"taxSystem": "US_SALES_TAX",
"rate": null
},
"userAgent": {
"browser": null,
"browserVersion": null,
"os": null,
"osVersion": null,
"deviceType": "bot"
}
}訪問者・バックエンドジオロケーション
訪問者のブラウザでは公開可能キーを使ってGET /v1/geoを、バックエンドでは指定したIPに対してシークレットキーを使ってGET /v1/lookup/{ip}またはPOST /v1/lookupを利用します。
すべてのチェックにひとつのプラン
ジオロケーション、IP検索、メール・登録・不可能な移動のチェックはすべて同じ月間リクエスト枠を消費します(呼び出し、チェックしたIP、またはアドレスごとに1リクエスト)。別途購入する製品はなく、Freeを含むすべてのプランで両方のキータイプを発行できます。
ドメインレベルのメールチェック
メールチェックは、構文、ドメインが使い捨てかどうかとそのメールサーバーレコード、入力ミスの可能性、ロールアドレスを確認します。メールボックスには一切接続しないため、アドレスが存在する、またはメールを受信できることを確認する結果はありません。
オリジンロック付きキー
APIキーはStripeやGoogle Mapsのキーと同様に公開可能です。リクエストは登録したオリジンに対してのみ処理され、CORSも同様にそのオリジンにのみ許可されます。
エッジジオロケーション
GET /v1/geoは接続元IPのネットワークレベルの位置データを読み取ります。IPによる位置情報はおおよそのものであり、応答時間はリクエスト内容と有効化された機能によって異なります。
地域エンリッチメント
訪問者レスポンスは、位置情報とリクエストヘッダーから通貨、国番号、日の出・日の入り時刻、デバイスに関する情報を導出します。元データが利用できない場合、フィールドはnullになることがあります。
地域コンプライアンスの参考情報
静的な国・地域マッピングにより、コンプライアンスに関する参考情報を提供します。法的義務を定めるものではなく、コンプライアンスを保証するものでもありません。
ロケール判定を代わりに実行
すべてのレスポンスにはlocaleオブジェクトが含まれます:訪問者の国とブラウザのAccept-Languageヘッダーを組み合わせた最適なBCP47ロケール(例:カナダにいるフランス語話者の訪問者にはfr-FRではなくfr-CAを返します)、さらに単位系、週の始まりの曜日、日付形式も含まれます—独自のi18nレイヤーでこれを再実装する必要はありません。
祝日カレンダー
すべてのレスポンスにはholidayオブジェクトが含まれます:訪問者の国で本日が祝日かどうか、その名称、そして次の祝日—「本日は休業」というサポートウィジェットの表示や、チェックアウト時の案内、スケジュール管理のロジックなどに便利です。厳選された約40か国のリストを対象としています。
年齢に関する法域の参考情報
静的なマッピングにより、おおよそのIP位置情報に基づいた年齢・法域の参考情報を提供します。本人確認や年齢確認を行うものではなく、適用される要件については別途ご確認ください。
税務法域の参考情報
静的なマッピングにより、地域の税務に関する参考情報を提供します。税額計算ではなく、継続的に更新される税務エンジンの代替にもなりません。
SDKソースパッケージ
リポジトリにはJavaScript/TypeScript、Python、PHP、Go、Flutter/Dartのクライアントが含まれています。対応エンドポイントは異なりますので、インストール前にドキュメントとパッケージの提供状況を確認してください。
VPN・Tor・ネットワークシグナル
対象の訪問者向けプランには、リスト型のVPN・Tor・データセンター・脅威・制裁対象ネットワークの指標が含まれます。誤検知(false)は利用可能なデータに一致がなかったことを意味し、その訪問者が安全であることを示すものではありません。IPv6の対応範囲は一部のみで、IPv6のTorは対象外です。
ブランド化されたサブドメイン
GrowthおよびScaleプランには、ダッシュボードでのカスタムドメイン設定機能が含まれます。利用可否はアカウントの適格性、DNSとSSLの設定成功に依存し、統合には設定済みのベースURLを使用する必要があります。
インポッシブルトラベルシグナル
POST /v1/risk/checkは、指定されたIPのおおよその位置情報を、保存済みのユーザーのベースラインと比較します。誤検知が発生する可能性があり、アカウント乗っ取りを証明するものではありません。利用可否と提供状況についてはお問い合わせください。
統合前にレスポンスを理解する
訪問者APIとルックアップAPIは異なるリクエストを処理し、異なるデータを返します。訪問者ジオロケーションは接続元リクエストのエッジジオロケーションを使用し、地域情報を追加します。IPルックアップは、指定したアドレスをサードパーティのIPジオロケーションデータベースで解決します。ルックアップのレスポンスには訪問者ジオロケーションにあるすべてのエンリッチメントは含まれません—例えば、郵便番号とタイムゾーンは現行のデータソースでは提供されません。メール・登録・リスクのチェックは、送信した入力(アドレス、またはユーザーIDとIP)を対象とし、下表のすべての行が同じ月間リクエスト枠を消費します。
| 用途 | エンドポイント | キー | データの内容 |
|---|---|---|---|
| 接続元のウェブサイト訪問者を特定する | GET /v1/geo | 公開可能・オリジン制限あり | 訪問者の位置情報と地域情報 |
| 指定した1件のIPをルックアップする | GET /v1/lookup/{ip} | シークレットBearerキー | サードパーティのIPジオロケーションデータベースの位置情報結果 |
| 指定した複数のIPをルックアップする | POST /v1/lookup | シークレットBearerキー | 最大100件の順序付き位置情報結果 |
| 登録フォームでメールアドレスをチェック | POST /v1/email/validate | 公開可能・オリジン制限あり | 構文・使い捨てドメイン・メールサーバー・入力ミスのシグナルと判定 |
| メールアドレスを一括チェック | POST /v1/email/batch, /v1/email/jobs | シークレットBearerキー | 1リクエストあたり最大100件、または非同期リストジョブで最大100,000件 |
| 新規登録をスコアリング | POST /v1/signup/check | シークレットBearerキー | メール・IPネットワーク・ドメイン経過年数のシグナルから0〜100のスコア |
| ログインを前回の位置と比較 | POST /v1/risk/check | シークレットBearerキー | 距離、推定速度、不可能な移動フラグ |
よくある質問
指定したIPアドレスをWatch-IPでジオロケーションできますか?
はい。シークレットキーを使ったサーバーサイドのIPルックアップAPIをご利用ください。ブラウザ向けの訪問者エンドポイントは接続元のクライアントを特定するものであり、任意のIPを指定してルックアップすることはできません。
ブラウザのJavaScriptからWatch-IPを利用できますか?
ウェブサイトのオリジンに合わせて設定した公開可能キーを使い、訪問者ジオロケーションをご利用ください。シークレットのルックアップキーはバックエンドに保管し、ブラウザのコードには絶対に含めないでください。
IPジオロケーションはブラウザのGeolocation APIと同じですか?
いいえ。Watch-IPはIP接続から位置情報を推定します。ブラウザのGeolocation APIは別の仕組みで、デバイスが提供する位置情報の利用許可を求めるものです。
IPv4とIPv6アドレスの両方をルックアップできますか?
ルックアップエンドポイントは、有効なIPv4・IPv6アドレスを受け付けます(データベースに記録がある場合に限ります)。セキュリティシグナルの対応範囲は別の話であり、指標やIPバージョンによって異なります。
Watch-IPに無料プランはありますか?
はい。Freeプランには月間リクエスト枠と、より小さいIP検索枠が含まれます。現在の上限は料金ページをご確認ください。メール・登録・不可能な移動のチェックは同じ枠を消費し、別のプランは不要です。
メールチェックはメールボックスの存在を確認しますか?
いいえ。Watch-IPは構文、ドメイン(使い捨てリスト、メールサーバーレコード、経過年数)、入力ミスやロールアカウントなどのアドレスパターンをチェックします。メールサーバーには接続しないため、メールボックスが存在する、またはメールを受信できることを確認する結果はありません。
メールチェックやリスクチェックには別のプランが必要ですか?
いいえ。チェックしたアドレス、登録チェック、不可能な移動チェックはそれぞれ、ジオロケーションや検索の呼び出しと同じ月間枠の1リクエストとして数えられます。バックエンドのエンドポイントは、ダッシュボードで発行するシークレットキーを使用します。
セキュリティのフラグがfalseなら、その訪問者は安全と言えますか?
いいえ。それは、使用しているデータの中に一致が見つからなかったことを意味するだけです。カバレッジの欠落、未収録のネットワーク、利用できないシグナルについては別途考慮する必要があります。
最初の統合先を選ぶ
Webサイトなら訪問者ガイドから、バックエンドアプリケーションならIP検索の製品ページから、登録フォームならメールチェックから始めましょう。