API Reference
中文

International IP Pro

API Format

Base URL

API

URLRequest MethodsContent-TypeOutput FormatCharacter Set
api-base-url?partner_code=xxx&partner_key=xxxPOSTapplication/jsonJSONUTF-8

example: https://sg.apitd.net/verification/persona/ip/pro/v1?partner_code=test_code&partner_key=test_key

Authentication
ParameterTypeDescriptionRequired/OptionalNotes
partner_codeStringPartner Coderequiredassigned by TD
partner_keyStringPartner Keyrequiredassigned by TD

Request

ParameterTypeDescriptionRequired/OptionalNotes
ipStringPublic IP AddressrequiredIPV4 and IPV6 supported

Request Example

{
    "ip": "210.20.10.33"
}

Response Parameter

ParameterTypeDescriptionNotes
codeIntegerAPI Status Code
messageStringStatus Messagespecific abnormal reasons will be provided if the API is abnormal
sequence_idStringUnique ID of ResponseA unique ID used to mark each request
continentStringContinent
country_idStringCountry ID
countryStringCountry
provinceStringProvince
cityStringCity
longitudeStringLongitude
latitudeStringLatitude
ownerStringOwner
operatorStringOperator
zip_codeStringZip Code
time_zoneStringTime Zone
domainStringDomain
asnStringAS Number
asStringAS Name
risk_scoreIntegerRisk Scorerange: 0 - 100
scenarioStringScenarioenumeration:
reserved
unallocated
unrouted
unused
used
isp
idc
ixp
school
satellite_comms
enterprise
organization
home_broadband
mobile_network
wlan
infra
dedicated
anycast
cdn
authenticity_scoreIntegerAuthenticity Scorerange: 0 - 100
network_risk_labelsArrayNetwork Riskproxy
idc
vpn
dynamic
tor
scan
brute_force
risk_labelsArrayBehavioral Risktampered_device
fake_device
high_risk_device

API Status Code

codeDescription
200Success
301Service not purchased
302Traffic blocked
303Traffic insufficient
304Service expired
305Daily maximum volume reached
9600System error
9601Illegal ip
9606Illegal parameter

Response Example

{
  "code": 200,
  "message": "",
  "sequence_id": "1648777165770866F82AC7F326307055",
  "continent": "asian",
  "country_id": "cn",
  "country": "china",
  "province": "zhejiang",
  "city": "hangzhou",
  "longitude": "120.288024",
  "latitude": "30.174930",
  "owner": "china mobile",
  "operator": "china mobile",
  "zip_code": "310000",
  "time_zone": "utc+8",
  "domain": "xxx.com",
  "asn": "4538",
  "as": "cnix-ap",
  "risk_score": 85,
  "scenario": "idc",
  "authenticity_score": 30,
  "network_risk_labels": ["idc", "proxy"],
  "risk_labels": ["fake_device"]
}