POSTPublicip-query-v3

IP Geolocation Lookup (High Precision)

Provides highly accurate global IP geolocation lookup services, including detailed information such as country, state/province, city, and ISP, empowering data analysis and business decisions.

Documentation

Features

This API provides highly accurate global IP geolocation lookup services. By entering any IP address, you can quickly retrieve detailed geographical information, including country, state/province, city, district/county, ISP, and latitude/longitude coordinates. Our authoritative data sources are updated in real-time to ensure high accuracy and timeliness. This "High Precision" version features optimized data matching algorithms and multi-dimensional data source integration, delivering industry-leading geolocation capabilities tailored for business scenarios requiring extreme location accuracy.

Use Cases

User Profiling: Identify user geographic distribution to optimize product and operational strategies.
Risk Control & Anti-Fraud: Detect anomalous transactions or login requests based on IP geolocation to prevent fraudulent activities.
Content Delivery & Recommendation: Recommend localized content or services based on the user's IP region.
Log Analysis & Security Auditing: Track source IPs of attacks for security protection and threat intelligence analysis.
Targeted Advertising: Deliver ads to users in specific regions to improve conversion rates.

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

{
  "ip": "114.114.114.114"
}

Response Example

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "country": "中国",
    "province": "江苏省",
    "city": "南京市",
    "district": "鼓楼区",
    "operator": "电信"
  }
}

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
ip	string	114.114.114.114

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
code	string	SUCCESS
message	string	success
data	object	{...}
data.country	string	中国
data.province	string	江苏省
data.city	string	南京市
data.district	string	鼓楼区

curl --request POST \ --url 'https://openapi.toolkk.com/v1/ip-query-v3' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "ip": "114.114.114.114"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/ip-query-v3" payload = { "ip": "114.114.114.114" } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.request("POST", url, headers=headers, json=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/ip-query-v3" payload := []byte("{\n \"ip\": \"114.114.114.114\"\n}") req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"ip\": \"114.114.114.114\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/ip-query-v3")) .method("POST", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/ip-query-v3'; $payload = "{\n \"ip\": \"114.114.114.114\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;

IP Geolocation Lookup (High Precision)

Documentation

Features

Use Cases

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Shell Example

Python Example

Go Example

Java Example

PHP Example

Try it online