API

API Documentation

FckMyIP provides a free, public REST API to retrieve IP geolocation data. No authentication required. Responses are returned in JSON format.

Base URL

Base URL https://fckmyip.com

All endpoints return JSON with Content-Type: application/json. HTTPS is required.

Dual-stack endpoints (IPv4 / IPv6)

To reliably detect both your IPv4 and IPv6 addresses, use the dedicated dual-stack subdomains. Each subdomain resolves exclusively via one protocol, ensuring the correct address type is returned.

GET https://v4.fckmyip.com/api/ip
GET https://v6.fckmyip.com/api/ip

v4.fckmyip.com has only A records (IPv4), and v6.fckmyip.com has only AAAA records (IPv6). If your network does not support a given protocol, the corresponding request will fail.

Request

IPv4

cURL 
curl https://v4.fckmyip.com/api/ip

IPv6

cURL 
curl https://v6.fckmyip.com/api/ip

Auto-detect your IP

Returns geolocation data for the caller's IP address. The IP is detected automatically from the request.

GET /api/ip

Request

No parameters required. The API detects your public IP automatically.

cURL 
curl https://fckmyip.com/api/ip

Response

200 OK 
{
  "ip": "203.0.113.42",
  "version": "IPv4",
  "city": "Paris",
  "region": "Île-de-France",
  "country": "France",
  "countryCode": "FR",
  "continentCode": "EU",
  "latitude": 48.8566,
  "longitude": 2.3522,
  "timeZone": "Europe/Paris",
  "isp": "Orange S.A.",
  "asn": 3215,
  "isEu": true
}

Lookup a specific IP

Returns geolocation data for any given IPv4 or IPv6 address.

GET /api/ip/{address}

Parameters

Name Type Description
address string IPv4 or IPv6 address to look up

Request

IPv4

cURL 
curl https://fckmyip.com/api/ip/8.8.8.8

IPv6

cURL 
curl https://fckmyip.com/api/ip/2001:4860:4860::8888

Response

200 OK 
{
  "ip": "8.8.8.8",
  "version": "IPv4",
  "city": "Mountain View",
  "region": "California",
  "country": "United States",
  "countryCode": "US",
  "continentCode": "NA",
  "latitude": 37.386,
  "longitude": -122.0838,
  "timeZone": "America/Los_Angeles",
  "isp": "Google LLC",
  "asn": 15169,
  "isEu": false
}

Response fields

Field Type Description
ipstringThe queried IP address
versionstring"IPv4" or "IPv6"
citystring?City name (may be null)
regionstring?Region or state (may be null)
countrystring?Country name (may be null)
countryCodestring?ISO 3166-1 alpha-2 country code
continentCodestring?Two-letter continent code (EU, NA, AS...)
latitudenumber?Approximate latitude
longitudenumber?Approximate longitude
timeZonestring?IANA time zone identifier
ispstring?Internet Service Provider name
asnnumber?Autonomous System Number
isEubooleanWhether the country is in the European Union

Error responses

Errors are returned as JSON with an "error" field describing the issue.

Status Condition Response body
400 IP address could not be detected {"error": "Unable to detect IP address"}
404 IP not found in database or invalid format {"error": "IP not found or invalid"}

Code examples

JavaScript (fetch)

JS 
const response = await fetch("https://fckmyip.com/api/ip");
const data = await response.json();
console.log(`${data.ip} — ${data.city}, ${data.country}`);

Python (requests)

Python 
import requests

data = requests.get("https://fckmyip.com/api/ip").json()
print(f"{data['ip']} — {data['city']}, {data['country']}")

C# (HttpClient)

C# 
using var http = new HttpClient();
var json = await http.GetStringAsync("https://fckmyip.com/api/ip/8.8.8.8");
Console.WriteLine(json);

PowerShell

PS 
Invoke-RestMethod https://fckmyip.com/api/ip | Format-List

Direct lookup link

You can link directly to a lookup result on the FckMyIP homepage by passing an IP address as a query parameter. The page will load and automatically trigger a search for the given address.

GET /?ip={address}

Request

URL 
https://fckmyip.com/?ip=8.8.8.8

This opens the interactive map view with the geolocation result displayed. Useful for sharing a lookup result or embedding a link in documentation.

Rate limits & fair use

This API is free and requires no API key. We ask that you use it responsibly: avoid mass automated queries and excessive polling. Abusive usage may result in your IP being rate-limited or blocked without notice. If you need high-volume access, please contact us at contact@cognitys.com.