Delivery · Real-Time REST API & Official SDKs
Sub-millisecond IPv4 & IPv6 intelligence over HTTP/2 and HTTP/3
Query a single IP, resolve your visitor’s caller IP without a key, or enrich 100 addresses per batch request pinned to an atomic Radix/LPM snapshot. Backed by 8 official zero-bloat server SDKs.
In-memory LPM p502.1 µsZero database I/O on the hot path
Batch capacity100 IPs / callPinned to a single snapshot version
Official SDKs8 languagesBuilt-in O(1) LRU cache & streaming
Overflow metering$0.10 / 1KOptional prepaid micro-USD wallet
LookupController
Single IP, caller IP, atomic 100-IP batch, and CIDR network inspection
Every API endpoint is served from an in-memory Radix/LPM routing snapshot with live BGP and geofeed enrichment on cache misses. Field projection happens automatically based on your API key’s licensedFamilies.
- GET /v1/ip/{ip}: Resolve any IPv4 or IPv6 address in sub-millisecond memory.
- GET /v1/ip/me: Keyless, proxy-aware caller IP lookup for CLI tools and edge diagnostics.
- POST /v1/ip/batch: Resolve up to 100 IPs in one round-trip with pre-debit validation.
- GET /v1/networks/{prefix}/{length}: Inspect canonical routing prefix records by CIDR.
import { IpScopeClient } from '@ipscope/sdk-node';
const client = new IpScopeClient({ apiKey: process.env.IPSCOPE_KEY });
// 1. Single IPv4/IPv6 lookup (cached in bounded O(1) LRU)
const info = await client.lookupIp('198.51.100.7');
console.log(info.geo.country_code, info.security.is_vpn);
// 2. Stream 10,000+ IPs in 100-IP chunks with constant RAM
for await (const chunk of client.lookupBatchStream(largeIpList)) {
for (const record of chunk.results) {
console.log(record.ip, record.network.asn);
}
}REST API v1 endpoint summary
All endpoints are served over HTTPS from https://api.ipscope.io.
| Method | Endpoint | Auth Scope | Metering | Description |
|---|---|---|---|---|
| GET | /v1/ip/{ip} | lookup | 1 credit | Single IPv4 or IPv6 lookup with live BGP enrichment-on-miss. |
| GET | /v1/ip/me | Public (None) | Free (120/min) | Proxy-aware lookup of the connecting client IP. |
| POST | /v1/ip/batch | batch | 1 credit / IP | Batch lookup of 1 to 100 IPv4/IPv6 addresses. |
| GET | /v1/networks/{prefix}/{length} | lookup | Included | Canonical CIDR network prefix inspection. |
| GET | /v1/metadata/datasets | lookup | Included | Active and rollback snapshot versions and SHA-256 digests. |
| POST | /v1/feedback | lookup | Free | Submit geolocation or VPN false-positive corrections. |
Start with 30K free lookups a month.
No card, no trial clock. Upgrade when your traffic does, or download the database when you would rather keep it in-house.