API الخاص بـ تحديد موقع IP
احصل على بيانات تحديد الموقع الجغرافي لعنوان IP بما في ذلك الدول والمدينة ومزود خدمة الإنترنت. استخدم هذا المرجع لاختيار نقطة النهاية المناسبة ومعرفة ما تعيده بالضبط.
العمليات
GET /v1/ip
GET
/v1/ip
الرصيد: 1
معاملات الاستعلام
| المعامل | النوع | مطلوب |
|---|---|---|
| ip | string | اختياري |
| domain | string | اختياري |
حقول الرد
| الحقل | النوع |
|---|---|
ip |
string |
domain |
string | null |
geolocation |
object |
geolocation.country |
string | null |
geolocation.country_name |
string | null |
geolocation.region |
string | null |
geolocation.region_name |
string | null |
geolocation.city |
string | null |
geolocation.postal |
string | null |
geolocation.latitude |
number | null |
geolocation.longitude |
number | null |
geolocation.timezone |
string | null |
geolocation.precision |
string |
network |
object |
network.asn |
integer | null |
network.asn_name |
string | null |
network.asn_org |
string | null |
network.isp |
string | null |
network.connection_type |
string | null |
security |
object |
security.is_proxy |
boolean |
security.is_vpn |
boolean |
security.is_tor |
boolean |
security.is_tor_exit |
boolean |
security.is_datacenter |
boolean |
security.is_cloud |
boolean |
security.cloud_provider |
string | null |
security.threat_score |
integer |
security.is_vpn_suspected |
boolean |
security.vpn_suspected_provider |
string | null |
security.type_classification |
object |
security.type_classification.type |
string |
security.type_classification.confidence |
string |
security.fcrdns |
object |
security.fcrdns.ptr |
string | null |
security.fcrdns.fcrdns_valid |
boolean | null |
intelligence_summary |
object |
intelligence_summary.query_type |
string |
intelligence_summary.domain_resolved |
boolean |
intelligence_summary.cache_status |
string |
intelligence_summary.data_source |
string |
intelligence_summary.confidence |
string |
intelligence_summary.confidence_score |
integer |
intelligence_summary.asn_present |
boolean |
intelligence_summary.organization_present |
boolean |
intelligence_summary.country_present |
boolean |
intelligence_summary.security_signal_count |
integer |
intelligence_summary.risk_flags[] |
string[] |
intelligence_summary.hosting_category |
string |
meta |
object |
meta.query_time_ms |
integer |
meta.cached |
boolean |
meta.source |
string |
meta.data_updated_at |
string | null |
meta.attribution |
object |
meta.attribution.name |
string |
meta.attribution.url |
string |
meta.attribution.license |
string |
meta.attribution.license_url |
string |
meta.attribution.modified |
boolean |
meta.warning_code |
string | null |
طلب مثال
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/ip?ip=8.8.8.8&domain=status.openai.com"const response = await fetch("https://domscan.net/v1/ip?ip=8.8.8.8&domain=status.openai.com", {
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.get(
"https://domscan.net/v1/ip?ip=8.8.8.8&domain=status.openai.com",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/ip?ip=8.8.8.8&domain=status.openai.com", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(resp.Status, string(data))
}require "json"
require "net/http"
uri = URI("https://domscan.net/v1/ip?ip=8.8.8.8&domain=status.openai.com")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))مثال الرد
{
"ip": "8.8.8.8",
"domain": null,
"geolocation": {
"country": "US",
"country_name": "United States",
"region": null,
"region_name": "California",
"city": "Mountain View",
"postal": null,
"latitude": 37.422,
"longitude": -122.085,
"timezone": null,
"precision": "city"
},
"network": {
"asn": 15169,
"asn_name": "AS15169",
"asn_org": "Google LLC",
"isp": null,
"connection_type": "hosting"
},
"security": {
"is_proxy": false,
"is_vpn": false,
"is_tor": false,
"is_tor_exit": false,
"is_datacenter": true,
"is_cloud": true,
"cloud_provider": "Google Cloud",
"threat_score": 0,
"type_classification": {
"type": "datacenter",
"confidence": "high"
},
"fcrdns": {
"ptr": "dns.google",
"fcrdns_valid": true
}
},
"intelligence_summary": {
"query_type": "ip",
"domain_resolved": false,
"cache_status": "miss",
"data_source": "db-ip-lite+enrichment",
"confidence": "high",
"confidence_score": 100,
"asn_present": true,
"organization_present": true,
"country_present": true,
"security_signal_count": 2,
"risk_flags": [
"cloud",
"datacenter"
],
"hosting_category": "cloud"
},
"meta": {
"query_time_ms": 118,
"cached": false,
"source": "db-ip-lite+enrichment",
"data_updated_at": "2026-08-01T01:42:04.000Z",
"attribution": {
"name": "DB-IP Lite",
"url": "https://db-ip.com",
"license": "CC BY 4.0",
"license_url": "https://creativecommons.org/licenses/by/4.0/",
"modified": true
}
}
}
رموز حالة HTTP
200OK400طلب غير صالح401غير مصرح402الدفع مطلوب429طلبات كثيرة جداً503الخدمة غير متاحة504انتهت مهلة البوابة