Free · Zero-log · CORS-open

Free IP Geolocation API

The only free IP geolocation API with no API key required, no registration, CORS-open for browser JavaScript, and sub-50ms edge responses from 330+ Cloudflare data centers worldwide.

< 50ms Zero-log CORS enabled No API key
Quick start
curl https://golive.ly/api/ip
203.0.113.42

How the IP Geolocation API Works

1

Call the Endpoint

Send a GET request to /api/ip (plain text) or /api/tools/ip (JSON). No API key, no authentication, no headers needed.

2

Edge Processing

Cloudflare's 330+ data centers detect your IP, geolocation, ASN, TLS version, and Client Hints from the incoming request — all processed ephemerally in under 50ms.

3

Structured Response

Get back 27 fields of telemetry data as JSON. IP, city, country, ISP, ASN, HTTP protocol, TLS cipher, Cloudflare colo, TCP RTT, User-Agent, and Client Hints — zero logs, zero storage.

Base URL

https://golive.ly

All endpoints are served from the same edge network. No subdomain, no separate host, no API key required.

Authentication

No authentication required

No API key. No header. No query parameter. Just call the endpoint.

Endpoints

GET /api/ip Plain Text

Returns your public IP address as plain text. Ideal for shell scripts, CI/CD pipelines, and cron jobs.

Use: curl, bash, scripts
Example Request
curl https://golive.ly/api/ip
Example Response
203.0.113.42
GET /api/tools/ip JSON

Returns complete edge telemetry as JSON: IP, location, ASN, ISP, TLS version, TLS cipher, colo, TCP RTT, User-Agent, Client Hints.

Use: Applications, analytics, dashboards
Example Request
curl https://golive.ly/api/tools/ip
Example Response
{
  "success": true,
  "data": {
    "ip": "203.0.113.42",
    "ipVersion": "IPv4",
    "location": {
      "city": "Athens",
      "country": "GR",
      "region": "Attica",
      "postalCode": "",
      "latitude": 37.9838,
      "longitude": 23.7275,
      "timezone": "Europe/Athens"
    },
    "network": {
      "asn": "AS6799",
      "asnNum": 6799,
      "asOrganization": "Hellenic Telecommunications Organization"
    },
    "security": {
      "httpProtocol": "HTTP/2",
      "tlsVersion": "TLSv1.3",
      "tlsCipher": "AEAD-CHACHA20-POLY1305-SHA256",
      "colo": "ATH",
      "clientTcpRtt": 18
    },
    "userAgent": {
      "raw": "curl/8.7.1",
      "os": "",
      "browser": "",
      "device": ""
    },
    "clientHints": {
      "platform": "",
      "mobile": ""
    }
  },
  "meta": {
    "isDatacenter": false
  }
}
GET /badge/ip.svg SVG Badge

Returns a shields.io-style SVG badge showing the viewer's IP address. Perfect for GitHub READMEs, blog sidebars, and status pages.

Use: README badges, forums, docs
Example Request
<img src="https://golive.ly/badge/ip.svg" alt="My IP" />
Example Response
SVG image

Response Schema & Field Reference

{
  "success": true,
  "data": {
    "ip": "203.0.113.42",
    "ipVersion": "IPv4",
    "location": { "city": "Athens", "country": "GR" },
    "network": { "asn": "AS6799", "asOrganization": "Cosmote" },
    "security": { "tlsVersion": "TLSv1.3", "colo": "FRA" }
  }
}
FieldTypeDescription
ipstringYour public IPv4 or IPv6 address
ipVersionstring"IPv4" or "IPv6"
location.citystringCity from Cloudflare edge geolocation
location.countrystringISO 3166-1 alpha-2 country code
location.regionstringRegion/state name
location.postalCodestringPostal code (when available)
location.latitudenumberApproximate latitude
location.longitudenumberApproximate longitude
location.timezonestringIANA timezone (e.g. Europe/Athens)
network.asnstringAutonomous System Number (e.g. AS6799)
network.asnNumnumberASN as integer for programmatic use
network.asOrganizationstringISP or organization name
security.httpProtocolstringHTTP protocol version (e.g. HTTP/2)
security.tlsVersionstringTLS protocol version (e.g. TLSv1.3)
security.tlsCipherstringTLS cipher suite in use
security.colostringCloudflare colo IATA code (e.g. ATH)
security.clientTcpRttnumber | nullTCP round-trip time to edge in ms
userAgent.rawstringRaw User-Agent header value
userAgent.osstringParsed operating system
userAgent.browserstringParsed browser name
userAgent.devicestringParsed device type
clientHints.platformstringSec-CH-UA-Platform (e.g. macOS)
clientHints.mobilestringSec-CH-UA-Mobile (?0 or ?1)
meta.isDatacenterbooleanWhether the ASN belongs to a datacenter/VPN provider

HTTP Status Codes

StatusMeaning
200Success — response contains IP or telemetry data
400Bad request — invalid query parameters
429Too many requests — rate limit exceeded
500Internal server error — try again shortly

Usage & Rate Limits

100
requests / minute
per IP
∞
No daily cap
No API key
CORS
Access-Control-Allow-Origin: *
Browser-ready
Zero-log
No data written to disk
Ephemeral processing

Why Developers Choose This API

Edge Speed

Served from 330+ Cloudflare locations. No cold starts. Median <50ms.

Zero-Log

No data written to disk. Ephemeral processing.

CORS-Open

Access-Control-Allow-Origin: * for browser JavaScript.

Rich Telemetry

IP, geo, ASN, TLS, colo, RTT, UA, Client Hints — 27 fields.

CLI-Friendly

Plain text endpoint for curl, bash, cron, CI/CD pipelines.

Free Forever

No API key. No paid tiers. Commercial use allowed.

Frequently Asked Questions

Everything you need to know about the free IP geolocation API.

No. The golive.ly IP API requires zero authentication. No API key, no registration, no header, no query parameter. Just call the endpoint.

More Free Developer Tools from golive.ly