pricing background

IP Geolocation Database Documentation

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.

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.
  • 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...

Response

Loading response...

Fields Description

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

IP to Country Snapshot Status

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 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.

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.
  • 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...

Response

Loading response...

Fields Description

Fields
Details
Example
start_ip
Start IP address of the range
99.242.182.227
end_ip
End IP address of the range
99.242.182.227
location_identifiers
Geographical identifiers linked to the IP location
country_id
Internal country identifier
29
state_place_id
State/province place identifier
597
state_code
State/region code
CA-ON
district_place_id
District identifier
3961
city_place_id
City identifier
1650
geo_accuracy
Location accuracy and confidence metrics
accuracy_radius
Estimated accuracy radius (km)
5.49
confidence
Confidence level of geolocation result
high
dma_code
Designated Market Area code (if available)
postal_location
Postal and geographic coordinates
zip_code
Postal/ZIP code
N6A
latitude
Latitude coordinate
42.98492
longitude
Longitude coordinate
-81.24528
geo_name_id
GeoName identifier for location
10280121
time_zone_name
Time zone of the location
America/Toronto
network_info
Network and connection details
connection_type
Type of internet connection
Cable
company_details_id
Internal company identifier
2752938
asn_details_id
Autonomous System Number details ID
28986
abuse_details_id
Abuse contact record ID
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.

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...