IP Geolocation API

{
  "service_type": "platform",
  "base_url": "https://api.bigdatacloud.net",
  "auth_method": "api_key",
  "auth_config": {
    "header": "X-API-Key",
    "query_param": "key",
    "notes": "Free client-side endpoints require no key; server-side APIs require a key."
  },
  "endpoints": [
    {
      "name": "IP Geolocation",
      "path": "/data/client-ip",
      "method": "GET",
      "auth_required": false,
      "description": "Retrieve geolocation data for the caller's IP address. Returns city, country, location, confidence area, VPN/proxy detection, and ASN details."
    },
    {
      "name": "IP Geolocation for specific IP",
      "path": "/data/ip-geolocation",
      "method": "GET",
      "auth_required": true,
      "description": "Get geolocation, ownership, and connectivity details for a given IPv4 or IPv6 address."
    },
    {
      "name": "Reverse Geocoding",
      "path": "/data/reverse-geocode",
      "method": "GET",
      "auth_required": false,
      "description": "Convert GPS coordinates to locality, city, region, and country names. Free client-side use only."
    },
    {
      "name": "Public IP Detection",
      "path": "/data/client-ip",
      "method": "GET",
      "auth_required": false,
      "description": "Returns the public IP address of the requester."
    },
    {
      "name": "Phone Verification",
      "path": "/data/phone-verification",
      "method": "GET",
      "auth_required": true,
      "description": "Validate phone numbers in E.164 format, detect line type, and check disposable/temporary numbers."
    },
    {
      "name": "Email Verification",
      "path": "/data/email-verification",
      "method": "GET",
      "auth_required": true,
      "description": "Validate email syntax, MX records, and detect disposable addresses."
    },
    {
      "name": "Network Engineering",
      "path": "/data/asn",
      "method": "GET",
      "auth_required": true,
      "description": "Retrieve ASN details, BGP prefixes, and network ownership information."
    },
    {
      "name": "Tor Exit Node Check",
      "path": "/data/tor-exit-node-check",
      "method": "GET",
      "auth_required": false,
      "description": "Check if an IP address is a Tor exit node."
    },
    {
      "name": "GraphQL Endpoint",
      "path": "/graphql",
      "method": "POST",
      "auth_required": true,
      "description": "GraphQL interface for all APIs, allowing flexible querying of geolocation, reverse geocoding, phone/email, and network data."
    }
  ],
  "pricing_model": {
    "type": "subscription",
    "details": {
      "free_tier": true,
      "monthly_cost": "From $9.95 per month",
      "overage": "Pay-as-you-go overage available"
    }
  },
  "rate_limits": {
    "free_tier": "Subject to fair use policy",
    "paid_tiers": "Not publicly documented; likely volume-based"
  },
  "capabilities": [
    "IP geolocation (IPv4 and IPv6)",
    "City-level geolocation with confidence areas",
    "VPN, proxy, and Tor detection",
    "Risk scoring",
    "ASN intelligence and network data",
    "Reverse geocoding (GPS to locality)",
    "Email and phone number verification",
    "Public IP detection",
    "GraphQL API",
    "Official SDKs for Node.js, Python, PHP, .NET, Java, Go, Ruby, Rust",
    "Client-side libraries for JavaScript, React, React Native, Vue, Flutter, Swift, Kotlin",
    "MCP server for AI integration",
    "100+ languages for locality names",
    "Global coverage including seas and uninhabited areas",
    "High availability (99.999% SLA)",
    "GDPR compliant"
  ],
  "raw_analysis": "BigDataCloud is a mature, specialized platform providing IP geolocation and related location intelligence APIs. Founded in Australia, it offers a range of services beyond IP location, including reverse geocoding, phone/email verification, and network engineering tools. The company emphasizes patented technology (US Patent 11,792,110) and publishes daily accuracy benchmarks against competitors like MaxMind and IP2Location, indicating a focus on data quality and transparency. The platform supports both REST and GraphQL interfaces, which is notable in the geolocation industry, and provides official SDKs across major programming languages, reducing integration friction. The free tier and client-side APIs are attractive for small projects and testing, while paid plans start at $9.95/month, with pay-as-you-go overage, making it affordable for scaling. However, rate limits are not publicly detailed, and the free reverse geocoding API has a strict fair use policy limiting to device-based GPS data. The MCP server compatibility broadens its use in AI assistants. Overall, BigDataCloud appears to be a robust, developer-friendly platform with strong accuracy claims and broad language support, suitable for enterprises requiring reliable IP geolocation but not for those needing street-level addresses (reverse geocoding is locality-level only)."
}

3/3 tests passed

```json
{
  "overall": 78,
  "dimensions": {
    "token_efficiency": 8.5,
    "first_try_success": 7.0,
    "response_parseability": 9.0,
    "error_clarity": 7.5,
    "doc_quality": 8.0,
    "auth_simplicity": 7.0,
    "latency": 8.5,
    "consistency": 8.5
  },
  "pricing_normalized": {
    "free_tier": true,
    "entry_monthly_cost_usd": 9.95,
    "overage_available": true
  },
  "issues": [
    "No llms.txt detected - robots.txt and llms.txt checks returned the main HTML page rather than structured index files, meaning AI agents may lack a dedicated discovery endpoint for documentation",
    "Latency is consistent at ~200-500ms but not under 100ms, typical for API documentation sites",
    "Free tier availability unclear from platform description alone - while marked true, the extent of free usage (requests/month) is not stated"
  ],
  "recommendations": [
    "Add an llms.txt file to expose structured API documentation, endpoint summaries, and usage examples for AI agents to discover capabilities without parsing HTML",
    "Clearly document free tier limits (e.g., requests per month) and any rate limiting on the pricing or getting-started page",
    "Consider a dedicated /llms-full.txt with expanded details on GraphQL schema, SDK installation, and MCP server usage for deeper agent integration",
    "Include example API responses in documentation to clarify JSON structure for IP geolocation, risk scoring, and reverse geocoding endpoints"
  ]
}
```