IP to City Snapshots
The endpoint lets you specify a date parameter to fetch a snapshot for that day. It delivers a ZIP archive containing several .gz files, each holding different datasets such as abuse records, ASN information, country metadata, place names, and company details. At the core of the archive is ip-to-city-db.csv, which provides district and state-level mappings enriched with attributes like accuracy radius, geo-name IDs, latitude, and longitude.
File Extension: The API returns the result as a zip-compressed file (.zip) for efficient download and storage. To extract the file, follow this tutorial.
Fields Description
Fields
Details
Data Type
Example
start_ip
Start IP address of the range
string
99.242.182.227
end_ip
End IP address of the range
string
99.242.182.227
location_identifiers
Geographical identifiers linked to the IP location
country_id
Internal country identifier
number
29
state_place_id
State/province place identifier
number
597
state_code
State/region code
string
CA-ON
district_place_id
District identifier
number
3961
city_place_id
City identifier
number
1650
geo_accuracy
Location accuracy and confidence metrics
accuracy_radius
Estimated accuracy radius (km)
number
5.49
confidence
Confidence level of geolocation result
string
high
dma_code
Designated Market Area code (if available)
string
postal_location
Postal and geographic coordinates
zip_code
Postal/ZIP code
string
N6A
latitude
Latitude coordinate
number
42.98492
longitude
Longitude coordinate
number
-81.24528
geo_name_id
GeoName identifier for location
number
10280121
time_zone_name
Time zone of the location
string
America/Toronto
network_info
Network and connection details
connection_type
Type of internet connection
string
Cable
company_details_id
Internal company identifier
number
2752938
asn_details_id
Autonomous System Number details ID
number
28986
abuse_details_id
Abuse contact record ID
number
5536187