Quickstart
No signup. No API key. Just make a request.
curl
# Get info about your current IP curl https://romanblshkv.ru/api/ip # Response { "ip": "203.0.113.42", "country": "DE", "city": "Frankfurt", "org": "AS24940 Hetzner Online GmbH", "lat": 50.1109, "lon": 8.6821 }
IP Lookup
Geolocation and ASN info for any IPv4 or IPv6 address.
GET
/api/ip
Your current IP info
response
{ "ip": "string", "version": "IPv4" | "IPv6", "country": "string", // ISO 3166-1 alpha-2 "city": "string", "org": "string", // ASN + org name "lat": number, "lon": number }
GET
/api/ip/{address}
Lookup any IP address
Path parameters
address
string
IPv4 or IPv6 address to look up
example
curl https://romanblshkv.ru/api/ip/8.8.8.8
DNS Resolve
Resolve DNS records for any domain. Supports A, AAAA, MX, TXT, NS.
GET
/api/dns/{domain}
Resolve DNS records
Path parameters
domain
string
Domain name to resolve
Query parameters
type
string
Record type: A (default), AAAA, MX, TXT, NS
example
curl "https://romanblshkv.ru/api/dns/github.com?type=A" { "domain": "github.com", "type": "A", "records": ["140.82.121.4"], "ttl": 60 }
Request Headers
Echo back the headers sent in your request. Useful for debugging proxies and CDN setups.
GET
/api/headers
Echo request headers
example
curl https://romanblshkv.ru/api/headers { "host": "romanblshkv.ru", "user-agent": "curl/8.1.2", "accept": "*/*", "x-forwarded-for": "203.0.113.42" }
Error codes
All errors return JSON with a
message field.error codes
400 Bad Request — invalid input 404 Not Found — unknown endpoint 429 Too Many Requests — slow down (>600 req/min) 500 Server Error — something broke on our side