도메인/IP 위치 조회

도메인 또는 IP의 위치 정보를 조회합니다.

정보

Method

URL

POST

https://apick.app/rest/location

요청

Header

이름

필수

설명

CL_AUTH_KEY

인증키(MD5)

FormData

이름

타입

필수

설명

address

String

검색할 도메인 또는 IP

응답

본 API는 MaxMind GeoIP2 데이터를 기반으로 합니다. code(행정구역 코드)와 r3(동)는 항상 빈 값("")으로 반환되며, r1/r2 등 지명은 한글이 아닌 영문으로 제공됩니다(예: "서울특별시" → "Seoul"). net(ISP)은 IP에 따라 비어있을 수 있습니다.

Body

이름

타입

설명

data

Object

조회 데이터

geo

Object

위치 정보

country

String

국가 코드 (ISO, 예: KR)

code

String

행정구역 코드 (미지원, 항상 빈 값)

String

시/도 (영문, 예: Seoul)

String

시/군/구 (영문, 예: Geumcheon-gu)

String

동 (미지원, 항상 빈 값)

lat

Double

위도

long

Double

경도

net

String

ISP/조직명 (IP에 따라 빈 값일 수 있음)

String

IP 주소

success

Integer

과금 여부
0: 실패
1: 성공
3: 실패(timeout)

api

Object

API 호출 공통 데이터

success

Boolean

API 서버 정상 응답 여부

cost

Integer

API 호출 요금

Integer

API 응답 시간

pl_id

Integer

API 결제 로그 ID

예시

요청 예시


curl -k -X POST "https://apick.app/rest/location" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "address=apick.app"

응답 예시


{
    "data": {
        "geo": {
            "country": "KR",
            "code": "",
            "r1": "Seoul",
            "r2": "Geumcheon-gu",
            "r3": "",
            "lat": 37.4784,
            "long": 126.8982,
            "net": "KT"
        },
        "ip": "121.140.146.38",
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 30,
        "pl_id": 1595641,
        "ms": 517
    }
}

개발가이드