IPv4検索API

国、地域、都市、おおよその座標、タイムゾーン、ネットワークとその運営者、データセンターとプロキシのフラグ、そしてそのアドレスが不正利用や攻撃で報告されているかどうか、どの程度深刻かを示すthreatブロックを返します。ipパラメーターを省略すると呼び出し元自身のアドレスが返り、これはウェブサイトでよくある使い方です。

GEThttps://api.mygeocode.com/v1/ipv4?ip=...

デモで試す完全なリファレンス

例

リクエスト

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/ipv4?ip=8.8.8.8"

# The caller's own address
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/ipv4"

IPアドレスの都市レベルのジオロケーションは推定であり、それは今後も変わりません。アドレスは人ではなくネットワークに属するものだからです。国は99%を大きく超えるアドレスで正確です。都市は一般消費者向けISPで最も信頼性が高く、モバイルキャリアやデータセンターで最も低いため、それらにはフラグを付けています。

レスポンス

{
  "status": "ok",
  "ip": "1.0.164.165",
  "version": 4,
  "found": true,
  "prefix": "1.0.164.0/24",
  "country": "Thailand",
  "country_code": "TH",
  "continent": "Asia",
  "continent_code": "AS",
  "region": "Krung Thep Maha Nakhon",
  "region_code": null,
  "city": "Bangkok",
  "postcode": "10200",
  "lat": 13.749976,
  "lon": 100.516819,
  "timezone": "Asia/Bangkok",
  "utc_offset": "+07:00",
  "utc_offset_seconds": 25200,
  "is_eu": false,
  "asn": 23969,
  "as_name": "TOT Public Company Limited",
  "org": "TOT Public Company Limited",
  "usage_type": "Eyeball",
  "registry": "apnic",
  "allocated": "2008-10-22",
  "tags": ["dsl"],
  "is_anycast": false,
  "is_satellite": false,
  "is_datacenter": false,
  "is_proxy": false,
  "is_vpn_provider": false,
  "is_tor": false,
  "is_private": false,
  "abuse_email": "abuse@totisp.net",
  "threat": {
    "listed": true,
    "score": 90,
    "source_count": 2,
    "categories": ["abuse", "attacker"],
    "is_tor": false,
    "is_tor_exit": false,
    "is_bogon": false,
    "listings": [
      { "category": "abuse", "confidence": 100, "recency_days": 1 },
      { "category": "attacker", "confidence": null, "recency_days": null }
    ]
  },
  "updated_at": "2026-09-18 06:53:39"
}

返される内容

フィールド	意味
`country`, `country_code`	国名とISO 3166-1 alpha-2コードです。
`region`, `region_code`	州、県、またはそれに相当する区分と、存在する場合はそのISO 3166-2コードです。
`city`, `postcode`	都市と郵便番号の最良の推定値です。不明な場合は含まれません。
`lat`, `lon`	都市の座標、それがない場合は地域または国の中心の座標です。
`timezone`	所在地から求めたIANA名です。
`asn`, `org`	自律システム番号と、そのプレフィックスをアナウンスしている組織です。
`is_datacenter`	このアドレスはホスティングまたはクラウドの範囲にあります。都市は信頼できないものとして扱い、トラフィックが自動化されている可能性を考慮してください。
`is_proxy`, `is_tor`, `is_vpn_provider`	Torリレーやプロキシリストへの掲載を示すアドレス単位の根拠と、それとは別に、運営者がそもそもVPNサービスを販売しているかどうかです。
`usage_type`, `tags`, `registry`, `allocated`, `abuse_email`	ネットワークを運営する事業者の種類、その事業者タグ、どのレジストリがいつ割り当てたか、そして不正利用の連絡先です。
`threat`	レピュテーションブロック：掲載の有無、0から100のスコア、そのアドレスを掲載している独立した報告の数とカテゴリ、Torとbogonのフラグ、そして各掲載の確信度と経過期間です。毎日更新されます。

利用シーン

初回訪問のローカライズ

訪問者が何も入力する前に、既定の国、通貨、言語、単位を選択します。サーバーから訪問者のアドレスをipとして渡してください。

不正行為と不正利用のシグナル

IPの国と請求先の国を比較します。is_proxyとis_datacenterは判定ではなくシグナルとして扱ってください。

Cookieを使わないアクセス解析

クライアント側のトラッキングを一切使わず、アクセスログからサーバー側で国別・地域別に訪問を集計します。

料金と制限

1回の呼び出しは1リクエストで、一括処理では各アドレスが1件として数えられます。どのキーにも1日あたり2,500件の無料リクエストがあり、それを超えるとプリペイドクレジットから1件あたり€0.0001、Unlimitedキー（月額€50）なら追加料金はかかりません。料金。ip-api、ipinfo、ipstackから移行しますか？これらの形式は互換ホストとして利用できます。IPv6アドレスについてはIPv6検索APIをご覧ください。