IP Locator API

https://www.iping.cc/api
Admin
The IP Locator API provides detailed IP address information including continent, country, city,...
Tokens:1,430
Snippets:3
Trust Score:7.7
Update:11 months ago
Show doc for...
Tokens:
Raw
### GET /v1/query

Source: https://www.iping.cc/api/index

Retrieves location-based and additional metadata for a specified IPv4 address. The endpoint supports both GET and POST methods, but the example demonstrates a GET request with query parameters.

```APIDOC
## GET /v1/query

### Description
Queries the geographical location, ISP details, ASN information, company data, and risk assessment for a given IPv4 address.

### Method
GET / POST

### Endpoint
https://api.iping.cc/v1/query

### Parameters
#### Query Parameters
- **ip** (string) - Required - The IPv4 address to query (e.g., 1.13.14.76).
- **language** (string) - Optional - Language code for the response (e.g., en).

### Request Example
Example GET request URL: https://api.iping.cc/v1/query?ip=1.13.14.76&language=en

For POST, the body could include JSON like: {"ip": "1.13.14.76", "language": "en"} (though not explicitly documented).

### Response
#### Success Response (200)
- **code** (integer) - Response status code.
- **msg** (string) - Success message.
- **data** (object) - Object containing the IP details.
  - **ip** (string) - The queried IP address.
  - **continent** (string) - Continent of the IP location.
  - **country** (string) - Country of the IP location.
  - **region** (string) - Region or state of the IP location.
  - **city** (string) - City of the IP location.
  - **longitude** (string) - Longitude coordinate.
  - **latitude** (string) - Latitude coordinate.
  - **isp** (string) - Internet service provider name.
  - **is_proxy** (string) - Indicates if the IP is a proxy (true/false).
  - **type** (string) - IP type (e.g., native or broadcast).
  - **usage_type** (string) - Usage scenario (e.g., IDC).
  - **risk_score** (string) - Risk score value.
  - **risk_tag** (string) - Possible risky behaviors.
  - **asn** (string) - Autonomous System Number.
  - **as_owner** (string) - ASN organization name.
  - **as_type** (string) - ASN type (e.g., COM for Commercial).
  - **as_domain** (string) - ASN organization domain.
  - **as_country** (string) - Country of the ASN.
  - **company** (string) - Company name.
  - **company_domain** (string) - Company domain.
  - **company_type** (string) - Company type.
  - **company_country** (string) - Country of the company.

#### Error Response (500)
- **code** (integer) - Error status code (500).
- **msg** (string) - Error message (Bad Request).
- **data** (object) - Likely null or empty on error.

#### Response Example
{
    "code": 200,
    "data": {
        "ip": "1.13.14.76",
        "continent": "Asia",
        "country": "China",
        "region": "Jiangsu",
        "city": "Nanjing",
        "longitude": "118.767413",
        "latitude": "32.041544",
        "isp": "Shenzhen Tencent Computer Systems Company Limited",
        "is_proxy": "false",
        "type": "native",
        "usage_type": "IDC",
        "risk_score": "",
        "risk_tag": "",
        "asn": "AS45090",
        "as_owner": "Shenzhen Tencent Computer Systems Company Limited",
        "as_type": "COM",
        "as_domain": "tencent.com",
        "as_country": "CN",
        "company": "Tencent cloud computing (Beijing) Co., Ltd.",
        "company_domain": "tencent.com",
        "company_type": "COM",
        "company_country": "CN"
    },
    "msg": "success"
}
```

--------------------------------

### IP Locator API Response Example

Source: https://www.iping.cc/api/index

This JSON object represents a successful response from the IP Locator API. It includes details about the queried IP address, such as its geographical location (continent, country, city), ISP, proxy status, risk score, and associated ASN information. The response structure includes a status code, data payload, and a message.

```json
{
    "code":200,
    "data":{
        "ip":"1.13.14.76" ,
        "continent":"Asia",
        "country": "China",
        "region": "Jiangsu",
        "city": "Nanjing",
        "longitude": "118.767413",
        "latitude":  "32.041544",
        "isp":"Shenzhen Tencent Computer Systems Company Limited",
        "is_proxy": "false",
        "type": "native",
        "usage_type": "IDC",
        "risk_score":"",
        "risk_tag": "",
        "asn": "AS45090",
        "as_owner": "Shenzhen Tencent Computer Systems Company Limited",
        "as_type":  "COM",
        "as_domain": "tencent.com",
        "as_country": "CN",
        "company": "Tencent cloud computing (Beijing) Co., Ltd.",
        "company_domain": "tencent.com",
        "company_type": "COM",
        "company_country": "CN"
  },
    "msg": "success"
}
```
Tokens:
Raw