Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

IPGeolocation.io IP Geolocation API

IP geolocation API endpoints for looking up geographic location, network routing,ASN ownership, company attribution, timezone, currency, security threat intelligence,abuse contact, and User-Agent data. Accepts IPv4 addresses, IPv6 addresses, anddomain names. The single lookup endpoint (`GET /v3/ipgeo`) resolves one IP or domainper request. The bulk lookup endpoint (`POST /v3/ipgeo-bulk`) accepts up to 50,000entries per request and requires a paid plan.

IPGeolocation.io IP Geolocation API is one of 7 APIs that IPGeolocation.io publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include IP Geolocation. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 2 operations across 2 paths, and defines 20 schemas. It is described by OpenAPI 3.0.7, at version 3.0.

Requests are made against a single base URL, https://api.ipgeolocation.io.

2 operations 2 paths 20 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.7
API Version
3.0
Base URL
https://api.ipgeolocation.io
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

IPGeolocation.io IP Geolocation API declares 1 security scheme for authenticating requests. An API key is passed in the query as apiKey (ApiKeyAuth). By default, every request must be authenticated.

  • ApiKeyAuth — API key passed as the apiKey query parameter. Get yours from the [IPGeolocation dashboard](https://app.ipgeolocation.io/). For client-side usage, consider usin…

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 1 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

IP Geolocation 2

IP geolocation API endpoints for looking up geographic location, network routing, ASN ownership, company attribution, timezone, currency, security threat intelligence, abuse conta…

GET
/v3/ipgeo
IPGeolocation.io Single IP Geolocation Lookup
lookupIpGeolocation 6 params → 200400401404405423429499
POST
/v3/ipgeo-bulk
IPGeolocation.io Bulk IP Geolocation Lookup
bulkLookupIpGeolocation 5 params body → 200400401405413415429499

Schemas 20

The contract defines 20 schemas that model the data the API accepts and returns. The most detailed are Location (22 properties), Security (19 properties), TimeZone (16 properties), BulkGeolocationSuccessItem (13 properties). Each schema is shown below with its type and property counts.

BulkGeolocationResponseItem
A single element in the bulk lookup response array. Each element is either a full geolocation object or an error object containing only message.
UserAgent
object
Parsed User-Agent information. Only returned when include=useragent or include= is used. The API parses the User-Agent header from the request. For server-side…
8 properties
Security
object
Threat intelligence and anonymization signals for the IP. Only returned when include=security or include= is used. Costs 2 additional credits.
19 properties
CountryMetadata
object
Telephone, TLD, and language information for the country.
3 properties
ErrorResponse
object
Returned for any non-200 response. Contains only a human-readable message. Message text can vary by status and condition; examples in this spec are representat…
1 property 1 required
Location
object
Geographic location data for the IP address.
22 properties
Abuse
object
Abuse contact information for the network that owns this IP. Only returned when include=abuse or include= is used. Costs 1 additional credit.
8 properties
UserAgentDevice
object
Device information extracted from the User-Agent string.
4 properties
UserAgentEngine
object
Rendering engine information extracted from the User-Agent string.
4 properties
Currency
object
Local currency of the country where the IP is located.
3 properties
Asn
object
Autonomous System Number details for the IP. Free plans receive asnumber, organization, and country only. Paid plans also receive type, domain, dateallocated,…
7 properties
BulkGeolocationSuccessItem
object
13 properties 1 required
IpGeolocationResponse
object
The top-level response object for a single IP lookup. Where fields and nested objects appear depends on your plan (free vs. paid) and the include, fields, and…
13 properties 1 required
Network
object
Network routing information for the IP. Included by default on paid plans. Not available on the free plan.
3 properties
BulkGeolocationRequest
object
Request body for the bulk geolocation lookup. Contains a single ips field with an array of IP addresses or domain names to look up.
1 property 1 required
DstTransition
object
Details about a DST transition (start or end). Only present when dstexists is true. When dstexists is false, dststart and dstend are returned as empty objects…
6 properties
UserAgentOperatingSystem
object
Operating system information extracted from the User-Agent string.
5 properties
BulkGeolocationErrorItem
object
Error object returned for an invalid entry in the bulk lookup request. Contains only a message field. Note: unlike success entries, error entries do NOT includ…
1 property 1 required
Company
object
Company or organization operating the IP range. Included by default on paid plans. Not available on the free plan.
3 properties
TimeZone
object
Timezone information for the geographic location of the IP.
16 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ipgeolocation-ip-geolocation-api-openapi.yml Raw ↑

Other APIs IPGeolocation.io publishes across the network.

IPGeolocation.io ASN Lookup API
IPGeolocation.io Astronomy API
IPGeolocation.io IP Abuse Contact API
IPGeolocation.io IP Security API
IPGeolocation.io Timezone API
IPGeolocation.io User Agent API