City

​

Key Attributes

​

Object Relationships

• Subdivision: Each city belongs to a subdivision (state, province, region)
• Country: Through the subdivision hierarchy, cities are associated with countries
• Continent: Through the country hierarchy, cities are associated with continents
• Proxies: Proxies can be geo-located in specific cities
• Residential Proxies: Residential proxy generation can target specific cities
• Mobile Proxies: Mobile proxy generation can target specific cities

​

Related Endpoints

​

Example Response

{
  "data": {
    "city_alias": "chittagong",
    "city_creation_datetime": "2024-07-03 13:48:00",
    "city_example_postcode": null,
    "city_id": 377157,
    "city_is_populous": true,
    "city_last_update_datetime": "2024-07-03 13:48:00",
    "city_latitude": 22.3384,
    "city_longitude": 91.83168,
    "city_name": "Chattogram",
    "city_node_count": 0,
    "city_population": 3920222,
    "city_timezone": "asia/dhaka",
    "subdivision_id": "bd-b"
  },
  "message": "City successfully retrieved."
}

​

Usage Notes

• The city_alias is particularly important for residential/mobile proxy targeting
• The city_is_populous flag indicates cities that are among the top ten largest in their timezone with at least 300,000 population
• Geographic targeting by city provides the most granular level of geographic control for proxy selection
• Not all cities are available for residential/mobile proxy targeting - generally only those with city_is_populous set to true
• The city_timezone attribute is useful for time-sensitive operations that need to account for local time
• When searching for cities, you can filter by country using the country_id parameter or by subdivision using the subdivision_id parameter
• The combination of city latitude and longitude can be used for geolocation services and mapping integrations