IP Location Checker

Look up geographic locations for IP addresses. Supports batch lookups with country, city, subdivision, coordinates, and timezone data.

The IP database refreshes every week automatically -each run checks for the latest version and caches it for 24 hours.

What data can you get?

• Country -Name and ISO 3166-1 alpha-2 code (e.g., US, HK, JP)
• Subdivision -State, province, or region
• City -City name
• Postal code -ZIP or postal code
• Coordinates -Latitude and longitude
• Timezone -IANA timezone identifier (e.g., America/Chicago, Asia/Hong_Kong)
• Accuracy radius -Approximate accuracy in kilometers
• Multi-language -Location names in 10+ languages (en, de, fr, ja, zh-CN, etc.)

Use cases

• Ad targeting validation -Verify that ad impressions are served to the correct geographic regions
• Fraud detection -Flag users whose IP location doesn't match their claimed location
• Content localization -Determine user regions for serving localized content
• Access control -Enforce geographic restrictions on APIs or content
• Analytics enrichment -Add location data to IP-based logs and analytics pipelines
• Compliance -Identify traffic from specific jurisdictions for regulatory compliance

Quick start

Basic lookup

{
    "ipAddresses": ["8.8.8.8", "1.1.1.1", "103.235.46.39"]
}

With language

{
    "ipAddresses": ["8.8.8.8", "103.235.46.39"],
    "language": "zh-CN"
}

Input

Field	Type	Description
ipAddresses	array	List of IP addresses to look up (IPv4 or IPv6). Required.
language	string	Language for location names, ISO 639-1 code (default: en)

Supported languages

en, de, es, fr, ja, pt-BR, ru, zh-CN -availability depends on the GeoLite2 database coverage for each location.

Output

Results are pushed to the default Dataset as JSON objects.

Example output

{
    "ip": "8.8.8.8",
    "country": "United States",
    "countryCode": "US",
    "subdivision": null,
    "city": null,
    "postalCode": null,
    "latitude": 37.751,
    "longitude": -97.822,
    "timezone": "America/Chicago",
    "accuracyRadius": 1000,
    "success": true,
    "error": null
}

Output fields

Field	Type	Description
ip	string	The queried IP address
country	string	Country name in the requested language
countryCode	string	ISO 3166-1 alpha-2 country code
subdivision	string	State, province, or region
city	string	City name
postalCode	string	Postal/ZIP code
latitude	number	Approximate latitude
longitude	number	Approximate longitude
timezone	string	IANA timezone identifier
accuracyRadius	integer	Accuracy radius in kilometers
success	boolean	Whether the lookup succeeded
error	string	Error message if lookup failed