API Reference

curl -X GET \
  "https://api.hostinfo.com/v2/ip/8.8.8.8" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

# Response
{
  "ip": "8.8.8.8",
  "country": "US",
  "org": "Google LLC",
  "asn": "AS15169",
  "city": "Mountain View"
}

import requests

r = requests.get(
    "https://api.hostinfo.com/v2/ip/8.8.8.8",
    headers={"Authorization": "Bearer YOUR_API_TOKEN"}
)
data = r.json()
print(data["org"])     # "Google LLC"
print(data["country"]) # "US"

const res = await fetch(
  'https://api.hostinfo.com/v2/ip/8.8.8.8',
  { headers: { Authorization: 'Bearer YOUR_API_TOKEN' } }
);
const data = await res.json();
console.log(data.org);     // "Google LLC"
console.log(data.country); // "US"

$ch = curl_init('https://api.hostinfo.com/v2/ip/8.8.8.8');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = json_decode(curl_exec($ch), true);
echo $data['org'];     // "Google LLC"

curl -X GET \
  "https://api.hostinfo.com/v2/ip/8.8.8.8" \
  -H "Authorization: Bearer YOUR_TOKEN"

r = requests.get("https://api.hostinfo.com/v2/ip/8.8.8.8",
    headers={"Authorization": "Bearer YOUR_TOKEN"})
data = r.json()

const data = await (
  await fetch('https://api.hostinfo.com/v2/ip/8.8.8.8',
    { headers: { Authorization: 'Bearer YOUR_TOKEN' } })
).json();

{
  "ip":            "8.8.8.8",
  "hostname":       "dns.google",
  "anycast":        true,
  "city":           "Mountain View",
  "region":         "California",
  "region_code":    "CA",
  "country":        "US",
  "country_name":   "United States",
  "continent":      "NA",
  "postal":         "94043",
  "lat":            37.386,
  "lon":            -122.083,
  "timezone":       "America/Los_Angeles",
  "utc_offset":     "-0700",
  "currency":       "USD",
  "org":            "Google LLC",
  "asn":            "AS15169",
  "asn_name":       "GOOGLE",
  "asn_type":       "hosting",
  "route":          "8.8.8.0/24",
  "domain":         "google.com",
  "company_name":   "Google LLC",
  "company_domain": "google.com",
  "company_type":   "hosting",
  "privacy": {
    "vpn": false, "proxy": false,
    "tor": false, "relay": false,
    "hosting": true
  },
  "abuse_email":    "[email protected]",
  "abuse_phone":    "+16502530000",
  "rir":            "ARIN",
  "bogon":          false
}

curl -X POST \
  "https://api.hostinfo.com/v2/ip/batch" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ips":["8.8.8.8","1.1.1.1","104.21.1.1"]}'

r = requests.post(
    "https://api.hostinfo.com/v2/ip/batch",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    json={"ips": ["8.8.8.8", "1.1.1.1", "104.21.1.1"]}
)
results = r.json()  # list of dicts

const res = await fetch('https://api.hostinfo.com/v2/ip/batch', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ ips: ['8.8.8.8', '1.1.1.1'] })
});
const results = await res.json(); // array

curl "https://api.hostinfo.com/v2/domain/google.com" \
  -H "Authorization: Bearer YOUR_TOKEN"

r = requests.get("https://api.hostinfo.com/v2/domain/google.com",
    headers={"Authorization": "Bearer YOUR_TOKEN"})

const data = await (
  await fetch('https://api.hostinfo.com/v2/domain/google.com',
    { headers: { Authorization: 'Bearer YOUR_TOKEN' } })
).json();

{
  "domain":          "google.com",
  "registrar":        "MarkMonitor Inc.",
  "registrar_url":    "https://markmonitor.com",
  "whois_server":     "whois.markmonitor.com",
  "created_date":     "1997-09-15T04:00:00Z",
  "updated_date":     "2023-09-14T08:12:00Z",
  "expiry_date":      "2028-09-14T04:00:00Z",
  "status": [
    "clientDeleteProhibited",
    "clientTransferProhibited"
  ],
  "nameservers": [
    "ns1.google.com", "ns2.google.com",
    "ns3.google.com", "ns4.google.com"
  ],
  "dnssec": "unsigned",
  "registrant_org": "Google LLC",
  "registrant_country": "US"
}

curl "https://api.hostinfo.com/v2/asn/AS15169" \
  -H "Authorization: Bearer YOUR_TOKEN"

r = requests.get("https://api.hostinfo.com/v2/asn/AS15169",
    headers={"Authorization": "Bearer YOUR_TOKEN"})

const data = await (
  await fetch('https://api.hostinfo.com/v2/asn/AS15169',
    { headers: { Authorization: 'Bearer YOUR_TOKEN' } })
).json();

{
  "ip":      "8.8.8.8",
  "email":   "[email protected]",
  "phone":   "+16502530000",
  "org":     "Google LLC",
  "rir":     "ARIN",
  "handle":  "ABUSE5250-ARIN",
  "network": "8.8.8.0/24"
}

{
  "ip":             "198.51.100.1",
  "threat_score":   74,
  "threat_level":   "high",
  "signals": {
    "vpn":          true,
    "proxy":        false,
    "tor":          false,
    "datacenter":   true,
    "abuse_reports": 12,
    "blocklisted":  true
  },
  "recommendation": "block"
}

{
  "ip":          "198.51.100.1",
  "listed":      true,
  "list_count":  4,
  "lists": [
    { "name": "Spamhaus SBL",   "last_seen": "2026-04-10" },
    { "name": "SORBS DUHL",     "last_seen": "2026-04-15" },
    { "name": "Barracuda BRBL", "last_seen": "2026-04-12" },
    { "name": "AbuseIPDB",      "last_seen": "2026-04-17" }
  ]
}

pip install hostinfo

import hostinfo

hi = hostinfo.Client("YOUR_API_TOKEN")

# IP lookup
ip = hi.ip("8.8.8.8")
print(ip.city, ip.country, ip.asn)

# Batch lookup
results = hi.ip_batch(["8.8.8.8", "1.1.1.1"])

# Domain lookup
domain = hi.domain("google.com")
print(domain.registrar, domain.expires)

# ASN lookup
asn = hi.asn("AS15169")
print(asn.asn_name, asn.num_prefixes_v4)

npm install @hostinfo/sdk

import HostInfo from '@hostinfo/sdk';

const hi = new HostInfo('YOUR_API_TOKEN');

// IP lookup
const ip = await hi.ip('8.8.8.8');
console.log(ip.city, ip.country);

// Domain lookup
const domain = await hi.domain('google.com');
console.log(domain.registrar);

composer require hostinfo/php-sdk

use HostInfo\Client;

$hi = new Client('YOUR_API_TOKEN');

// IP lookup
$ip = $hi->ip('8.8.8.8');
echo $ip->city . ', ' . $ip->country;

// ASN lookup
$asn = $hi->asn('AS15169');
echo $asn->asn_name;

go get github.com/hostinfo/go-sdk

package main

import (
  "fmt"
  hi "github.com/hostinfo/go-sdk"
)

func main() {
  client := hi.New("YOUR_API_TOKEN")

  ip, _ := client.IP("8.8.8.8")
  fmt.Println(ip.City, ip.Country)

  asn, _ := client.ASN("AS15169")
  fmt.Println(asn.Name)
}

gem install hostinfo

require 'hostinfo'

hi = HostInfo::Client.new('YOUR_API_TOKEN')

ip = hi.ip('8.8.8.8')
puts ip.city, ip.country

asn = hi.asn('AS15169')
puts asn.asn_name