IP Geolocation API: Retrieving Province, City, and District Information with Adcode and Bounding Box
Tech
3
This API provides IP-based geolocation data, returning details such as province, city, district names, adcode identifiers, and a reference coordinate. It is a paid service with a cost of 1 point per call, and a free alternative is available via a redirect link. For long-term usage, contact via WeChat at xujian_cq for subscription options. To obtain the required access code, use the mini-program "Digital Continuity" and sign in on its homepage. The interface does not contain sensitive information; if any infringement occurs, contact the author for removal.
API Functionality
- Accepts an IPv4 adress and returns the corresponding province, city, district names, adcode, and a reference coordinate.
API Usage
Key Parameters
- Input Parameters
| No. | Item | Value | Description |
|---|---|---|---|
| 1 | Endpoint URL | https://api.example.com/geolocation/vip | API endpoint for VIP access |
| 2 | HTTP Method | GET | Request method |
| 3 | Parameter 1 | auth_token | Access token obtained from the "Digital Continuity" mini-program; it is static and must be kept confidential |
| 4 | Parameter 2 | target_ip | IPv4 address to query for location |
Note: The auth_token is immutable; ensure it is secured.
- Output Format
| No. | Item | Value | Description |
|---|---|---|---|
| 1 | Response Format | JSON Object | Contains status_code, result_data, message |
| 2 | Response 1 | status_code | 200 indicates success; other values indicate failure |
| 3 | Response 2 | message | Descriptive text: "success" for success, error details for failure |
| 4 | Response 3 | result_data | JSON object with geolocasion information |
Return Values
| No. | Parameter Name | Type | Description |
|---|---|---|---|
| 1 | region_info.province | String | Province or direct-controlled municipality name |
| 2 | region_info.city | String | City name |
| 3 | region_info.district | String | District or county name |
| 4 | region_info.adcode | Integer | Administrative code for the location |
| 5 | coordinates.latitude | Double | Latitude coordinate |
| 6 | coordinates.longitude | Double | Longitude coordinate |
Request Example
# Replace ${YourAuthToken} with the token from the "Digital Continuity" mini-program; keep it confidential
curl "https://api.example.com/geolocation/vip?target_ip=203.0.113.1&auth_token=${YourAuthToken}"
Response Example
{
"status_code": 200,
"message": "success",
"result_data": {
"coordinates": {
"latitude": 31.2304,
"longitude": 121.4737
},
"region_info": {
"country": "China",
"province": "Shanghai",
"city": "Shanghai",
"district": "Pudong New Area",
"adcode": 310115,
"country_code": 156
}
}
}
Pricing Model
- Charged at 1 point per API call. A free version is accessible via a redirect link. For bulk or long-term usage, contact WeChat at xujian_cq to discuss annual or monthly plans.
Usage Monitoring
- Free to use; no query limits. After logging into the website, view call statistics under "API Services - IP Geolocation (VIP)".
- Explore additional features on the site.
// Monitoring dashboard URL
https://monitor.example.com
Additional API Services
- More APIs are being updated regularly.
