How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
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.2.0, 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.2.0
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), IpGeolocationResponse (13 properties). Each schema is shown below with its type and property counts.

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
Network
object
Network routing information for the IP. Included by default on paid plans. Not available on the free plan.
3 properties
CountryMetadata
object
Telephone, TLD, and language information for the country.
3 properties
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
UserAgentEngine
object
Rendering engine information extracted from the User-Agent string.
4 properties
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.
Currency
object
Local currency of the country where the IP is located.
3 properties
UserAgentDevice
object
Device information extracted from the User-Agent string.
4 properties
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
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
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
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
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
UserAgentOperatingSystem
object
Operating system information extracted from the User-Agent string.
5 properties
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
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
BulkGeolocationSuccessItem
object
13 properties 1 required

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
Where this information came from

This is an independent, third-party profile of IPGeolocation.io IP Geolocation API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.