API Documentation

Use the free API from 내아이피.kr to look up IP information programmatically.

Rate Limit: 60 requests per minute per IP. If exceeded, an HTTP 429 response is returned with a Retry-After: 60 header. Responses include X-RateLimit-Limit and X-RateLimit-Remaining headers.
GET /Api/MyIp

Returns the requester's public IP address, location information, and User-Agent details.

Response Example
{
  "ip": "203.0.113.1",
  "geo": {
    "country": "South Korea",
    "countryCode": "KR",
    "city": "Seoul",
    "regionName": "Seoul",
    "isp": "Korea Telecom",
    "org": "Korea Telecom",
    "as": "AS4766",
    "lat": 37.5665,
    "lon": 126.978,
    "timezone": "Asia/Seoul",
    "isProxy": false
  },
  "userAgent": {
    "browser": "Chrome",
    "browserVersion": "131.0.0.0",
    "os": "Windows 10/11",
    "deviceType": "Desktop"
  }
}
Usage Examples
curl https://xn--220b31d95hq1c.kr/Api/MyIp
fetch('https://xn--220b31d95hq1c.kr/Api/MyIp')
  .then(res => res.json())
  .then(data => console.log(data.ip));
import requests
r = requests.get('https://xn--220b31d95hq1c.kr/Api/MyIp')
print(r.json()['ip'])
GET /Api/IpLookup?ip={ip}

Looks up location information for a specified IP address.

Parameters
ParameterTypeRequiredDescription
ipstringYesIP address to look up (IPv4 or IPv6)
Response Example
{
  "success": true,
  "data": {
    "query": "8.8.8.8",
    "country": "United States",
    "countryCode": "US",
    "regionName": "Virginia",
    "city": "Ashburn",
    "isp": "Google LLC",
    "lat": 39.0438,
    "lon": -77.4874,
    "isProxy": false,
    "isHosting": true
  }
}
Usage Examples
curl "https://xn--220b31d95hq1c.kr/Api/IpLookup?ip=8.8.8.8"
GET /Api/PortCheck?port={port}

Checks whether a specified port is open on the requester's IP. (Only available for your own IP.)

Parameters
ParameterTypeRequiredDescription
portintYesPort number to check (1–65535; dangerous ports are blocked)
Response Example
{
  "success": true,
  "data": {
    "port": 80,
    "status": "Closed",
    "responseTime": 15
  }
}

Status: Open / Closed / Filtered / Blocked / RateLimit

GET /Api/DnsLookup

Returns the Reverse DNS result for the requester's IP.

Response Example
{
  "success": true,
  "data": {
    "ip": "203.0.113.1",
    "reverseDns": "host-203-0-113-1.example.com"
  }
}
External Widget

Insert the code below into your web page to display the visitor's IP address.

<div id="myip-widget"></div>
<script src="https://xn--220b31d95hq1c.kr/js/widget.js"></script>