API Docs↗
NETWORK INTELLIGENCE

IP Geolocation API.

Resolve a public IP address into structured location and network intelligence for AI agents, developers and automated systems.

$0.003Per request
USDCPayment currency
BaseMainnet
x402Machine payment
IP INTELLIGENCE

Public IP data,
ready for agents.

DataBG returns structured JSON including city, region, country, coordinates, timezone, organization, ASN and hostname.

ENDPOINT

GET /v1/tools/ip/geolocation

Pass a public IPv4 or IPv6 address using the ip query parameter.

?ip=8.8.8.8
JSONIPv4IPv6
RESPONSE

Structured network data

Receive machine-readable location and network attributes without scraping a web page.

CityCountryASNTimezone
USE CASES

Agent workflows

Useful for fraud analysis, security workflows, localization, network intelligence and automated enrichment.

FraudSecurityEnrichment
MACHINE-READABLE

Integrate with DataBG.

Discover the complete capability definition and request schema through the DataBG API.

View OpenAPI →
DETAILED DOCUMENTATION

API reference for AI agents and developers.

DataBG tools are designed as small, machine-readable building blocks for automated workflows. Each request uses a predictable HTTP endpoint and can be accessed with an API key or, where enabled, through x402 machine payments.

IP GEOLOCATION API

Turn a public IP address into structured network intelligence

The DataBG IP Geolocation API resolves a public IPv4 or IPv6 address into machine-readable geolocation and network information. It is designed for AI agents, developers and automated systems that need location and network context as part of a larger workflow.

Request

GET https://api.databg.tech/v1/tools/ip/geolocation?ip=8.8.8.8

Required parameter: ip — a public IPv4 or IPv6 address.

Available intelligence

The current response can include IP address, city, region, country, country code, postal code, latitude, longitude, timezone, organization, ASN and hostname. A privacy-related field may also be present when available.

Example response

{
  "success": true,
  "ip": "8.8.8.8",
  "city": "Mountain View",
  "region": "California",
  "country": "US",
  "country_code": "US",
  "timezone": "America/Los_Angeles",
  "organization": "Google LLC",
  "asn": "AS15169",
  "hostname": "dns.google"
}

Agent use cases

Typical applications include network enrichment, localization, security workflows, fraud-analysis pipelines and automated IP research. Geolocation should be treated as an approximate intelligence signal rather than an exact physical location.

Access and pricing

The current listed price is $0.003 per request in USDC on Base Mainnet. The successful response is structured JSON, making it suitable for direct agent consumption.

MACHINE PAYMENTS

How x402 access works

DataBG paid tools can use the HTTP 402 Payment Required flow. A compatible client requests a resource, receives machine-readable payment requirements, settles the requested amount in USDC on Base Mainnet, and retries the request with payment authorization. This model is designed for autonomous software that can discover and pay for individual API calls.

Agent → DataBG endpoint
       ↓
402 Payment Required
       ↓
USDC payment on Base Mainnet
       ↓
Retry with payment authorization
       ↓
Structured JSON

For implementation details, use the live API specification and machine-readable discovery resources linked below.

Open API specification → Machine-readable discovery →