Bot detection & IP intelligence

// POST https://api.getbotscore.com/v1/analyze

{
  "ip": "66.249.64.1",
  "user_agent": "Googlebot/2.1 (+http://www.google.com/bot.html)",
  "headers": {}
}

{
  "ip": "66.249.64.1",
  "bot_score": 0.82,
  "is_bot": true,
  "classification": "search_engine",
  "sub_type": "googlebot",
  "confidence": "high",
  "signals": {
    "ua_pattern":     { "score": 0.9, "weight": 1.0 },
    "ip_type":        { "score": 0.6, "weight": 0.8 },
    "header_anomaly": { "score": 0.0, "weight": 0.5 },
    "reputation":     { "score": 0.5, "weight": 0.3 }
  },
  "geo": {
    "country": "US",
    "city": "Mountain View",
    "isp": "Google LLC"
  },
  "processing_ms": 1.2
}

// POST https://api.getbotscore.com/v1/geolocate
// { "ip": "8.8.8.8" }

{
  "ip": "8.8.8.8",
  "location": {
    "continent": "North America",
    "continent_code": "NA",
    "country": "United States",
    "country_code": "US",
    "region": "California",
    "region_code": "CA",
    "city": "Mountain View",
    "postal_code": "94043",
    "latitude": 37.386,
    "longitude": -122.084,
    "timezone": "America/Los_Angeles"
  },
  "network": {
    "asn": 15169,
    "org": "GOOGLE",
    "isp": "Google LLC",
    "ip_type": "datacenter"
  },
  "security": {
    "is_datacenter": true,
    "is_vpn": false,
    "is_proxy": false,
    "is_tor": false,
    "is_crawler": false
  },
  "processing_ms": 0.8
}

curl -X POST https://api.getbotscore.com/v1/analyze \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{
    "ip": "66.249.64.1",
    "user_agent": "Googlebot/2.1"
  }'

import requests

resp = requests.post(
    "https://api.getbotscore.com/v1/analyze",
    headers={"X-Api-Key": "YOUR_API_KEY"},
    json={
        "ip": "66.249.64.1",
        "user_agent": "Googlebot/2.1"
    }
)

data = resp.json()
print(f"Bot score: {data['data']['bot_score']}")
print(f"Classification: {data['data']['classification']}")

const resp = await fetch("https://api.getbotscore.com/v1/analyze", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Api-Key": "YOUR_API_KEY"
  },
  body: JSON.stringify({
    ip: "66.249.64.1",
    user_agent: "Googlebot/2.1"
  })
});

const { data } = await resp.json();
console.log(`Bot score: ${data.bot_score}`);
console.log(`Classification: ${data.classification}`);