Available countries and regions

Returns currently available regions in a country → state/province → city hierarchy, with quality and scale ratings at country and state levels so you can filter targets by need. No authentication required.

Endpoint

This page documents the new areas2 API. Compared with the older flat list, it adds a tree structure plus successLevel (success-rate rating) and ipCountLevel (IP-count rating).

Endpoint

Item	Value
Method	GET
URL	https://api2.ipmart.io/ipmart/common/areas2
Auth	None
Content-Type	application/json

Example:

https://api2.ipmart.io/ipmart/common/areas2

Request parameters

None.

Response structure

data is an object:

Field	Type	Description
upTime	Long	Data update time (Unix timestamp in milliseconds)
countryList	Array	Country list

Hierarchy:

data
└─ countryList[]          # country
   ├─ successLevel        # success-rate level (country)
   ├─ ipCountLevel        # IP-count level (country)
   └─ stateList[]         # state / province
      ├─ successLevel     # success-rate level (state)
      └─ cityList[]       # city (no rating fields)

Country fields (countryList[])

Field	Type	Description
code	String	Country code (e.g. US, AE)
cntry	String	Country name in English
cntryName	String	Country name in Chinese
successLevel	Int	Success-rate level, 5–1 (see below)
ipCountLevel	Int	IP-count level, 5–1 (see below)
stateList	Array	States / provinces under this country

State / province fields (stateList[])

Field	Type	Description
state	String	State/province code or English key (for request parameters)
stateName	String	State/province display name
successLevel	Int	Success-rate level, 5–1 (supported at state level)
cityList	Array	Cities under this state

Note

States provide successLevel only — they do not include ipCountLevel.

City fields (cityList[])

Field	Type	Description
city	String	City code or English key (for request parameters)
cityName	String	City display name

Cities do not include success-rate or IP-count ratings.

Rating reference

successLevel (success-rate rating)

Higher values mean higher success rates:

Level	Meaning
5	Success rate 95%+
4	Success rate 90%+
3	Success rate 80%+
2	Success rate 70%+
1	Success rate below 70%

Applies to: country and state/province.

ipCountLevel (IP-count rating)

Higher values mean a larger available IP pool:

Level	Meaning
5	100,000+ IPs
4	10,000+ IPs
3	1,000+ IPs
2	100+ IPs
1	fewer than 100 IPs

Applies to: country only.

Tips

• If needed, filter countries and states by successLevel and ipCountLevel to match the quality you want.
• For overall live pool scale, see real-time online IP count.

Response example

Success

Truncated sample (the live response includes all countries / states / cities):

{
  "status": 200,
  "data": {
    "upTime": 1789219531759,
    "countryList": [
      {
        "code": "AE",
        "cntry": "United Arab Emirates",
        "cntryName": "阿拉伯联合酋长国",
        "successLevel": 5,
        "ipCountLevel": 4,
        "stateList": [
          {
            "state": "Abudhabi",
            "stateName": "Abudhabi",
            "successLevel": 5,
            "cityList": [
              {
                "city": "Abudhabi",
                "cityName": "Abudhabi"
              },
              {
                "city": "Alain",
                "cityName": "Alain"
              }
            ]
          },
          {
            "state": "Dubai",
            "stateName": "Dubai",
            "successLevel": 5,
            "cityList": [
              {
                "city": "Dubai",
                "cityName": "Dubai"
              }
            ]
          }
        ]
      },
      {
        "code": "US",
        "cntry": "United States",
        "cntryName": "美国",
        "successLevel": 5,
        "ipCountLevel": 5,
        "stateList": [
          {
            "state": "California",
            "stateName": "California",
            "successLevel": 5,
            "cityList": [
              {
                "city": "Losangeles",
                "cityName": "Losangeles"
              },
              {
                "city": "Sanfrancisco",
                "cityName": "Sanfrancisco"
              }
            ]
          }
        ]
      }
    ]
  }
}