مرجع المطورين
جغرافيا IP
باستخدام DomScan API، استخبارات IP تشمل الموقع الجغرافي وتفاصيل ASN والشبكة والإشارات الأمنية. يدعم البحث المباشر عن IP وتحليل النطاقات.
جغرافيا IP
استخبارات IP تشمل الموقع الجغرافي وتفاصيل ASN والشبكة والإشارات الأمنية. يدعم البحث المباشر عن IP وتحليل النطاقات. يتضمن كشف عقد خروج Tor وتحديد مزودي السحابة واكتشاف مراكز البيانات لمنع الاحتيال وتحليل الأمان.
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انتهت مهلة البوابة