Integrate IP intelligence in five minutes.
One canonical schema across the low-latency REST API, 8 official server SDKs, and downloadable .mmdb, .csv.gz and .parquet databases covering 35.3M+ routed IPv4 & IPv6 prefixes.
https://api.ipscope.ioAuthorization: Bearer ips_live_••••••••$0.10 / 1,000 lookupsQuickstart
Make your first IPv4 or IPv6 lookup with curl, an official server SDK, or a local MMDB file.
REST API Reference
Single IP, caller IP, 100-IP batch, CIDR prefix inspection, dataset catalog, and feedback endpoints.
Downloadable Databases
Run zero-latency local lookups on your own servers with MaxMind-compatible .mmdb, .csv.gz and .parquet files.
Official Server SDKs
Production-ready server libraries with bounded O(1) LRU caching, batch deduplication, and chunked streaming.
pip install ipscopenpm install @ipscope/sdk-nodego get github.com/ipscope-io/ipscope-gocargo add ipscopeio.ipscope:ipscope-sdk:1.0.0dotnet add package IpScope.Sdkgem install ipscopecomposer require ipscope/ipscope-phpREST API endpoints
/v1/ip/{ip}scope: lookupResolve any IPv4 or IPv6 address with live BGP/RIPEstat enrichment-on-miss.
/v1/ip/mePublicProxy-aware lookup of the connecting client’s public IPv4 or IPv6 address.
/v1/ip/batchscope: batchResolve up to 100 IPv4/IPv6 addresses in one request pinned to a single snapshot.
/v1/networks/{prefix}/{length}scope: lookupInspect canonical prefix records by split CIDR or URL-encoded /v1/networks/{cidr}.
/v1/metadata/datasetsscope: lookupList active and previous snapshot versions, SHA-256 digests, and prefix counts.
/v1/feedbackscope: lookupSubmit a network operator or researcher geolocation/anonymizer correction report.
Six intelligence blocks
country_code · declared_country_code · physical_country_code · is_virtual_location · location_type · confidencesubdivision · city · postal_code · latitude · longitude · accuracy_radius_km · timezoneasn · organization · matched_networkconnection_type · is_residential · is_mobile · is_business · is_hostingis_vpn · is_tor_exit · is_proxy · is_hosting · anonymizer_type · confidenceanonymizer_reason · threat_level · abuse_velocity · confidenceGetting Started & Data Model
- Quickstart guideFirst lookup in 60 seconds via curl, SDK, or MMDB
- AuthenticationBearer tokens, X-API-Key, and zero-downtime key rotation
- Response formatJSON envelope, nullability guarantees, and rate-limit headers
- Field referenceComplete schema for geo, network, connection, and security
- Privacy & VPN detectionUsing is_vpn, anonymizer_reason, and step-up verification
- Methodology & IPv6Declared vs. physical country and dual-stack IPv6 parity
REST API & Querying
- API Reference overviewConventions, TLS 1.3, connection pooling, and status codes
- Single IP lookupGET /v1/ip/{ip} with optional field_families filtering
- Caller IP lookupGET /v1/ip/me for zero-key diagnostics and edge checks
- Batch lookup (100 IPs)POST /v1/ip/batch and 10,000+ IP SDK streaming
- Network CIDR lookupGET /v1/network/{cidr} for prefix-level inspection
- Errors & Rate limitsMachine-readable error codes and Prepaid Micro-USD Wallet
Databases & Operations
- Database editions & SKUsCompare Lite, Country, ASN, City, Privacy, and Mega
- Custom database builderCompile a bespoke .mmdb, .csv.gz, or .parquet artifact
- MMDB, CSV & ParquetBinary radix trees, DuckDB Parquet queries, and Postgres COPY
- Downloading & checksumsGCS V4 signed URLs, ETag 304 caching, and SHA-256 verification
- Zero-downtime updatesAtomic mv replacement and systemd timer configuration
- Reading MMDB in codeMaxMind reader snippets across all 8 server languages