The 10 fields and concepts you'll meet in the response — defined in plain English, each with a real example value.
A unique numerical identifier assigned to each device connected to a network, used for communication and location identification.
IP addresses come in two versions: IPv4 (e.g., 192.168.1.1) and IPv6 (e.g., 2001:db8::1). ISPs assign IPs to users, often dynamically. Static IPs remain constant, while dynamic IPs change periodically. Geolocation APIs map IP addresses to physical locations.
Exampleip: "173.172.81.20" (IPv4), ip: "2001:4860:4860::8888" (IPv6)
Internet Service Provider—a company that provides internet access to customers.
ISPs are allocated blocks of IP addresses by Regional Internet Registries. IP geolocation APIs identify ISPs to determine connection type (residential, mobile, corporate) and to detect data center IPs.
An IP address assigned to a server in a hosting facility or cloud provider, not a residential user.
Datacenter IPs are used by web servers, VPNs, proxies, and bots. They're distinct from residential and mobile IP ranges. Detecting datacenter IPs helps identify non-human traffic and proxy usage.
The process of determining the physical location (country, city, coordinates) of a device or user.
Geolocation can be based on IP address (75-99% accurate), GPS (meter-level accuracy), Wi-Fi triangulation, or cell tower proximity. IP geolocation is fastest but least precise. It's suitable for content personalization, not navigation.
Examplecountry: "US", city: "Kansas City", coordinates: [39.0831, -94.5853]
Latitude and longitude values that specify a precise location on Earth's surface.
Latitude ranges from -90 (South Pole) to +90 (North Pole). Longitude ranges from -180 to +180, with 0 at the Prime Meridian. Coordinates are typically expressed as decimal degrees (e.g., 40.7128, -74.0060 for New York City).
Examplecoordinates: [39.0831, -94.5853] (Kansas City, MO)
The process of converting geographic coordinates (latitude/longitude) into a human-readable address.
Given coordinates like [40.7128, -74.0060], reverse geocoding returns "New York, NY, USA". It's useful for displaying location names from GPS data or map clicks.
ExampleInput: [40.7128, -74.0060] → Output: "New York, NY, USA"
A region of the Earth that observes a uniform standard time, identified by IANA timezone names.
Timezones are defined by their offset from UTC and their daylight saving time rules. IANA identifiers like "America/New_York" are preferred over abbreviations like "EST" because they handle DST automatically.
Exampletimezone: "America/Chicago" (UTC-6 in winter, UTC-5 in summer)
Coordinated Universal Time—the primary time standard by which the world regulates clocks and time.
UTC is not affected by daylight saving time. All timezones are expressed as offsets from UTC (e.g., UTC-5, UTC+1). When storing timestamps, always use UTC and convert to local timezones only for display.
Exampletimestamp: "2024-12-22T15:30:00Z" (Z indicates UTC)
Virtual Private Network—a service that encrypts internet traffic and routes it through a server in another location.
VPNs mask the user's true IP address and location. They're used for privacy, security, and bypassing geographic restrictions. VPN detection APIs identify traffic from known VPN providers with 95%+ accuracy.
An intermediary server that forwards requests on behalf of clients, often used for anonymity or content filtering.
Proxies can be transparent (identify themselves), anonymous (hide client IP), or elite (appear as regular traffic). Residential proxies use real residential IPs and are harder to detect than datacenter proxies.
