Integrate Today in 5 Minutes or Less

IP Geolocation API

Turn any IP address into rich location data instantly. Get country, city, timezone, currency, and network details with a single API call. Built for developers who need accurate, fast, and reliable geolocation data.

Global Coverage
Painless Integration
IPv4 & IPv6 Support
Frequent Updates
Get Started for Free Try Live Demo
No Credit Card Required
2,000 Free Requests

99.5%+

Country Accuracy

<100ms

Response Time

40+

Data Fields

300+

Edge Locations

IP Geolocation API Request & Response 
# Get location for any IP
curl "https://api.hummingbirdapi.com/v1/geo/lookup?ip=8.8.8.8" \
  -H "X-API-Key: hb_live_xxxxx"

{
  "success": true,
  "data": {
    "ip": "8.8.8.8",
    "ip_type": "ipv4",

    "location": {
      "continent_code": "NA",
      "continent_name": "North America",
      "country_code": "US",
      "country_code_iso3": "USA",
      "country_name": "United States",
      "country_capital": "Washington",
      "country_tld": ".us",
      "country_calling_code": "+1",
      "country_flag_emoji": "🇺🇸",
      "country_languages": ["en", "es"],
      "country_area_km2": 9833520,
      "country_population": 331449281,
      "country_neighbors": ["CA", "MX"],
      "country_is_eu": false,
      "region_code": "CA",
      "region_name": "California",
      "city_name": "Mountain View",
      "postal_code": "94043",
      "latitude": 37.386,
      "longitude": -122.084,
      "weather_code": "USCA0746"
    },

    "time": {
      "zone": "America/Los_Angeles",
      "abbr": "PST",
      "utc_offset": "-08:00",
      "utc_offset_seconds": -28800,
      "current_time": "2026-01-26T10:30:00-08:00",
      "current_timestamp": 1737913800,
      "is_dst": false
    },

    "currency": {
      "code": "USD",
      "name": "US Dollar",
      "symbol": "$"
    },

    "network": {
      "asn": 15169,
      "asn_organization": "Google LLC",
      "isp": "Google LLC",
      "organization": "Google LLC",
      "connection_type": "Corporate",
      "user_type": "hosting"
    }
  },
  "error": false,
  "error_code": null,
  "error_message": null
}

The Hummingbird IP Geolocation API is a REST API that converts any IPv4 or IPv6 address into precise geographic location data — including country, city, region, timezone, currency, and network information — with sub-100ms response times globally.

Key API Features

Everything you need to add IP Geolocation support to your stack in one simple API call.

Get comprehensive IP geolocation data integrated into your applications today.

Country Detection

Get ISO alpha-2, alpha-3 country codes, and full country name for any IP address.

City-Level Precision

Pinpoint users to the city level with region, state, and postal code data.

GPS Coordinates

Get precise latitude and longitude for mapping and distance calculations.

Continent Detection

Identify which continent an IP originates from with code and full name.

EU Membership Check

Instantly identify EU users for GDPR compliance and cookie consent flows.

Timezone Detection

Get IANA timezone identifier and abbreviation for scheduling and display.

Real-Time Local Time

Access current local time with Unix timestamp and ISO 8601 format.

Daylight Saving Status

Know if DST is active to handle time calculations and scheduling correctly.

Currency Detection

Detect local currency code, name, and symbol for price localization.

Country Flag Emoji

Display country flags instantly without maintaining your own asset library.

Calling Code

Get international dialing codes for phone number formatting and validation.

Language Detection

Identify primary languages spoken in the country for content localization.

ISP Identification

Detect the Internet Service Provider for network analysis and filtering.

ASN Lookup

Get Autonomous System Number and organization for network intelligence.

Connection Type

Identify if the connection is Corporate, Residential, Mobile, or other types.

User Type Detection

Distinguish between hosting, business, residential, and other user types.

Common Use Cases

Build smarter experiences with geolocation data.

Personalization

Content Localization

Show users content in their language and local currency automatically. Personalize experiences based on geographic context without asking users to set preferences.

🇺🇸

United States visitor

Detected via IP: 8.8.8.8

Currency

$USD

Language

EN

Timezone

PST

🇩🇪

Germany visitor

EU Member State detected

EU

Cookie Consent Required

country_is_eu: true

Compliance

GDPR Compliance

Identify EU users to display appropriate cookie consent banners and comply with privacy regulations. The API returns a simple country_is_eu boolean for easy implementation.

Security

Fraud Prevention

Detect suspicious activity by comparing user-claimed location with actual IP geolocation data. Flag transactions where billing address doesn't match IP location.

Transaction Check

Review
Billing Address New York, US
IP Location Lagos, NG
Location mismatch detected

Visitor Distribution

🇺🇸
United States 42%
🇬🇧
United Kingdom 18%
🇩🇪
Germany 12%
Insights

Analytics & Insights

Understand where your users are coming from to optimize marketing spend and infrastructure decisions. Build geographic dashboards and track regional trends.

Scheduling

Time-Zone Aware Scheduling

Schedule notifications, emails, and events based on the user's local time. Show live chat only during business hours in their timezone, or send marketing messages at optimal times.

User's Local Time

Online
Timezone America/Los_Angeles
Local Time 10:30 AM PST
DST Active No
Within business hours — show live chat

Network Intelligence

ISP Google LLC
ASN AS15169
Connection Type Corporate
User Type Hosting
Detected as data center traffic
Intelligence

Network Traffic Analysis

Identify bot traffic, data center IPs, and hosting providers. Distinguish between residential, corporate, and mobile connections to filter traffic and customize experiences.

Quick Start Guide

Get started now in 3 simple steps.

From signup to your first API call in under 5 minutes.

1

Get your free API key.

Create a free account and get an API key in just a few clicks. No credit card required.

Create My Free Account
2

Make your first request.

Call the API with any IP address. Omit the IP parameter to lookup the requester's IP.

cURL 
curl "https://api.hummingbirdapi.com/v1/geo/lookup?ip=8.8.8.8" \
  -H "X-API-Key: YOUR_API_KEY"
3

Parse the response.

Extract the data you need from the JSON response. Explore the docs for fields and examples.

JavaScript 
const response = await fetch(
  'https://api.hummingbirdapi.com/v1/geo/lookup?ip=8.8.8.8',
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
const { data } = await response.json();

console.log(data.location.city_name);     // "Mountain View"
console.log(data.location.country_code);  // "US"
console.log(data.time.zone);              // "America/Los_Angeles"

What is an IP Geolocation API?

How IP Geolocation Works

An IP Geolocation API converts IP addresses into geographic location data. Here's how:

  • Every internet-connected device has an IP address allocated to specific regions.
  • Our database maps IP ranges to geographic coordinates, ISPs, and organizations.
  • Returns 40+ data fields including location, timezone, currency, and network info.

Common Use Cases

  • Content localization: Show prices in local currency and content in the user's language.
  • Fraud prevention: Flag transactions where IP location doesn't match billing address.
  • GDPR compliance: Identify EU users to trigger appropriate consent flows.
  • Analytics: Understand geographic traffic distribution and regional trends.

Why Hummingbird?

  • Frequently updated: Database refreshed freqeuntly (even multiple times per day) for accuracy.
  • Edge-deployed: 300+ global locations for sub-100ms response times.
  • Developer-friendly: Clean JSON responses, simple integration, in any programming language.
Simple Integration

Discover how the IP Geolocation API works for you.

From request to response with pinpoint accuracy and low latency, anywhere in the world.

1

Request

Your application sends an API request with the IP address you want to lookup (or omit for the requester's IP).

2

Edge Processing

Our edge network processes your request at the nearest point of presence for minimal latency.

3

Response

You receive a JSON response with location, timezone, currency, and network data.

Complete IP Geolocation API Data Reference

Explore every field in the IP Geolocation API response.

40+ data points returned with every IP Geolocation API lookup, organized into logical groups for easy integration with your application stack.

Field Type Description
Core
ip string The IP address that was looked up
ip_type string IP version: "ipv4" or "ipv6"
Location
location.continent_code string Continent code (e.g., "NA")
location.continent_name string Continent name (e.g., "North America")
location.country_code string ISO 3166-1 alpha-2 country code (e.g., "US")
location.country_code_iso3 string ISO 3166-1 alpha-3 country code (e.g., "USA")
location.country_name string Full country name (e.g., "United States")
location.country_capital string Capital city (e.g., "Washington")
location.country_tld string Country top-level domain (e.g., ".us")
location.country_calling_code string Phone calling code (e.g., "+1")
location.country_flag_emoji string Country flag emoji (e.g., "🇺🇸")
location.country_languages array Official languages (e.g., ["en", "es"])
location.country_area_km2 number Country area in square kilometers
location.country_population number Country population estimate
location.country_neighbors array Neighboring country codes (e.g., ["CA", "MX"])
location.country_is_eu boolean Whether the country is in the EU
location.region_code string Region/state code (e.g., "CA")
location.region_name string Region or state name (e.g., "California")
location.city_name string City name (e.g., "Mountain View")
location.postal_code string Postal/ZIP code (e.g., "94043")
location.latitude number Latitude coordinate
location.longitude number Longitude coordinate
location.weather_code string Weather station code (e.g., "USCA0746")
Time
time.zone string IANA timezone (e.g., "America/Los_Angeles")
time.abbr string Timezone abbreviation (e.g., "PST")
time.utc_offset string UTC offset (e.g., "-08:00")
time.utc_offset_seconds number UTC offset in seconds (e.g., -28800)
time.current_time string Current local time (ISO 8601)
time.current_timestamp number Current Unix timestamp
time.is_dst boolean Whether daylight saving time is active
Currency
currency.code string ISO 4217 currency code (e.g., "USD")
currency.name string Currency name (e.g., "US Dollar")
currency.symbol string Currency symbol (e.g., "$")
Network
network.asn number Autonomous System Number
network.asn_organization string ASN organization name
network.isp string Internet Service Provider
network.organization string Organization name
network.connection_type string Connection type (e.g., "Corporate", "Residential")
network.user_type string User type (e.g., "hosting", "business")
40+

Data Fields

5

Data Categories

1

API Call

IP Geolocation API FAQ

Common questions, answered.

Everything you need to know about the IP Geolocation API.

Is there a free IP geolocation API?
Yes! Hummingbird offers a free tier with 2,000 lifetime API requests — no credit card required. It's perfect for testing, prototypes, and small projects. Create a free account to get started in minutes.
How accurate is the IP geolocation data?
Our geolocation data is accurate to the city level for most IPs. Country-level accuracy is 99.5%+, while city-level accuracy varies by region but typically exceeds 80% for well-connected areas. Mobile and VPN IPs may have reduced accuracy.
What is the API response time?
The IP Geolocation API delivers responses in under 100ms globally. We deploy at the edge across 300+ locations worldwide, so requests are processed at the nearest point of presence to minimize latency.
What programming languages do you support?
The API works with any language that can make HTTP requests — including JavaScript, Python, PHP, Ruby, Go, Java, C#, and more. We provide copy-paste code examples for all major languages. No SDK required.
Can you detect VPNs, proxies, or Tor?
The API returns network.user_type and network.connection_type fields that help identify hosting providers, data centers, and corporate networks. While not a dedicated VPN detection service, these fields flag many proxy and VPN exit nodes.
Do you support both IPv4 and IPv6?
Yes! The API fully supports both IPv4 and IPv6 addresses. Simply pass the IP address in the request parameter and we'll handle the rest.
What happens if I don't pass an IP address?
If you omit the IP parameter, the API will automatically use the IP address of the client making the request. This is useful for looking up your own users' locations.
How often is the geolocation database updated?
Our IP geolocation database is updated frequently (even up to multiple times per day) to ensure accuracy. We use multiple data sources and continuous validation to maintain high-quality data.
Do you store or log the IP addresses I look up?
No. We do not log or store the IP addresses you look up. Your lookup data is processed in real-time and never persisted. See our privacy policy for details.
Is there a rate limit?
Rate limits depend on your plan. The free tier includes 2,000 lifetime requests with up to 5 requests per second. Paid plans start at 25 requests per second. Check our pricing page for details.
Can I use this for GDPR compliance?
Yes! The API returns a country_is_eu field that indicates whether the IP is located in an EU member state. This is commonly used to trigger GDPR-compliant cookie consent flows.
How does Hummingbird compare to MaxMind or IPinfo?
Hummingbird offers comparable accuracy with simpler pricing and faster integration. Unlike per-lookup pricing models, we use predictable bucket-based pricing so you always know your costs. Plus, every plan includes all 40+ data fields — no upsells for "premium" data.

Ready to validate and integrate?

Claim your 2,000 free requests today. No credit card required.

Get Started for Free Talk to Sales