pricing background

IP Geolocation Database Documentation

IP to Country Snapshot Status

ASK AI
Use the endpoint to get the status of the latest IP to Country snapshot. The JSON output contains the snapshot name, creation date, and expected deletion date.

Authorization

You can make authorized requests to our API by passing API key as a query parameter. To get your API key, login to our billing dashboard and get your API key! If your API key has been compromised, you can change it by clicking on reset button in billing dashboard.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

IP to Country Snapshots

ASK AI
The endpoint accepts a date parameter to download the snapshot for a specific day and provides a ZIP archive containing multiple .gz files that act like a modular database. Each file holds specific datasets like abuse details, ASN information, country metadata, and place names linked together by IDs. The ip-to-country-db.csv file serves as the central mapping, connecting IPs to countries with confidence scores, ASN IDs, and abuse references.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
  • date
    Use the date parameter in yyyy-MM-dd (2026-01-26) format to get the snapshot of that day.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

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.

Response

Loading response...

Fields Description

Fields
Details
Data Type
Example
id
Unique identifier for the place record
number
7
place
Place name translated into multiple languages
place_english
Place name in English
string
Europe
place_german
Place name in German
string
Europa
place_russian
Place name in Russian
string
Европа
place_korean
Place name in Korean
string
유럽
place_portuguese
Place name in Portuguese
string
Europa
place_japanese
Place name in Japanese
string
ヨーロッパ
place_persian
Place name in Persian
string
اروپا
place_french
Place name in French
string
Europe
place_chinese
Place name in Chinese
string
欧洲
place_spanish
Place name in Spanish
string
Europa
place_czech
Place name in Czech
string
Evropa
place_italian
Place name in Italian
string
Europa
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
country_id
Internal country identifier for geolocation mapping
number
29
confidence
Confidence level of the geolocation result
string
high
time_zone_name
IANA time zone name of the IP location
string
America/Toronto
connection_type
Type of network connection (e.g., Cable, DSL, Mobile)
string
Cable
asn_details_id
Autonomous System Number details reference ID
number
28986
abuse_details_id
Abuse contact reference ID for reporting issues
number
5536187

IP to City Snapshot Status

Use the endpoint to get the status of the latest IP to City snapshot. The JSON output contains the snapshot name, creation date, and expected deletion date.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

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.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.
  • date
    Use the date parameter in yyyy-MM-dd (2026-01-26) format to get the snapshot of that day.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

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.

Response

Loading response...

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