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 Security API

IP security intelligence endpoints used to detect VPNs,proxies, Tor exit nodes, relay networks, bot activity,spam activity, cloud providers, and other anonymizationtechnologies associated with IP addresses.The single lookup endpoint (`GET /v3/security`) analyzesone IP per request.The bulk lookup endpoint (`POST /v3/security-bulk`)accepts up to 50,000 IP addresses per request.

IPGeolocation.io IP Security 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 Security. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 2 operations across 2 paths, and defines 7 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 7 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 Security 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 Security 2

IP security intelligence endpoints used to detect VPNs, proxies, Tor exit nodes, relay networks, bot activity, spam activity, cloud providers, and other anonymization technologies…

GET
/v3/security
IPGeolocation.io Single IP Security Lookup
lookupIpSecurity 4 params → 200400401404405423429499
POST
/v3/security-bulk
IPGeolocation.io Bulk IP Security Lookup
bulkLookupIpSecurity 3 params body → 200400401405413415429499

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are Security (19 properties), BulkSecuritySuccessItem (2 properties), IpSecurityResponse (2 properties), BulkSecurityRequest (1 property). Each schema is shown below with its type and property counts.

BulkSecurityErrorItem
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
BulkSecurityResponseItem
A single element in the bulk lookup response array. Each element is either a full security object or an error object containing only message.
Security
object
Threat intelligence and anonymization signals for the IP. Costs 2 credits.
19 properties
IpSecurityResponse
object
2 properties 1 required
BulkSecuritySuccessItem
object
2 properties 2 required
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
BulkSecurityRequest
object
Request body for the bulk security lookup. Contains a single ips field with an array of IP addresses to look up.
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ipgeolocation-ip-security-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 Geolocation API
IPGeolocation.io Timezone API
IPGeolocation.io User Agent API