API Center

Create API keys, test live, and explore docs & code examples. Integrate IP quality detection into your apps or scripts.

—Balance
—API Keys
—Total Calls
My Keys
Loading...
Live Console

Enter your API Key and an IP. The key stays in your browser only.

API Key *Forgot your key? Click the eye icon in the list
IP Address *
lang

Quick Start

1

Create an account

Sign up and log in to get a credit account

2

Create an API Key

Create in Workbench, copy and save (shown only once)

3

Recharge credits

Each call costs 1 credit. Keep your balance topped up

4

Start calling

Use code examples or the live console

Authentication

Pass your API Key via either method:

Method 1: Query parameter (simple)

bash
https://api.ipjiance.com/api/geoip?key=sk-your-api-key&ip=8.8.8.8&lang=zh

Method 2: Authorization header (recommended)

bash
https://api.ipjiance.com/api/geoip?ip=8.8.8.8&lang=en
Authorization: Bearer sk-your-api-key

Endpoints

GETPOST/api/geoip

Main IP detection endpoint. Requires API Key, costs 1 credit per call.

ParamRequiredDescription
ipYesPublic IPv4/IPv6 address
langNoEvaluate language zh/en
keyone of twoAPI Key or Authorization header

Code Examples

bash
# curl
curl "https://api.ipjiance.com/api/geoip?ip=8.8.8.8&lang=zh" \
  -H "Authorization: Bearer sk-your-api-key"

# 或用 query 参数
curl "https://api.ipjiance.com/api/geoip?key=sk-your-api-key&ip=8.8.8.8"

Response Fields

FieldTypeDescription
ipstringQueried IP address
country_codestringCountry code (ISO)
citystring|nullCity
longitude/latitudefloat|nullLng/Lat
time_zonestring|nullTimezone
ispstring|nullISP
organizationstring|nullOrganization
asnstring|nullASN
connection_typestring|nullConnection type
user_typestring|nullUser type
is_anonymous_vpnboolAnonymous VPN
is_public_proxyboolPublic proxy
is_tor_exit_nodeboolTor exit node
is_hosting_providerboolHosting/DC
is_blacklistboolBlacklisted
is_abuserboolAbuser
is_attackerboolAttacker
user_countintUser count
static_ip_scorefloatStatic IP score
pointsintScore (0-150)
evaluatestringEvaluation (localized)

Error Codes

HTTPCodeMeaningAction
200successSuccessProcess data
400IP_INVALIDInvalid IPCheck ip param
400IP_NOT_PUBLICNot public IPUse public IP
401APIKEY_INVALIDInvalid/disabled keyCheck key
402CREDIT_INSUFFICIENTNot enough creditsRecharge
429RATE_LIMITRate limitedSlow down
503DETECT_FAILEDService unavailableRetry (refunded)