Skip to content

EDGE IP GEOLOCATION & NETWORK INTELLIGENCE

Edge IP Geolocation API

Ultra-low latency IP intelligence and geolocation API. Lookup country, city, ASN, ISP, timezone, and proxy/VPN flags with edge caching.

Explore plans See how it works

500 free requests per application · monthly allowance.

LIVE API TRIAL

5 free live checks per IP every 24 hours · Sponsored by PayloadAPI

Checking live trial availability...

Use your own API key in the playground.
Create free account
Trust score
0 / 100
Versions
v1
Endpoints
2

02 THE BIGGER PICTURE

An IP address is more
than a network packet.

Every request that touches your application originates from an IP address. But where in the world is that user? Which autonomous system (ASN) and internet service provider routes their traffic? And is the connection coming from a known proxy, VPN, or hosting facility?

Edge IP Geolocation API resolves those network attributes in single-digit milliseconds directly from the nearest Cloudflare edge data center. Use the returned context to customize localization, stop fraudulent signups, and enrich telemetry streams.

One IP address goes in. Real-time edge network context comes back. You decide how that information powers your application.

Pinpoint geolocation

Country, region, city, postal code, latitude, longitude, and timezone.

Network & ASN intelligence

Identify the autonomous system (ASN), AS organization, ISP, and network routing range.

Threat & proxy risk signals

Detect VPN, proxy, Tor exit nodes, and hosting infrastructure flags in real time.

Single-digit ms edge latency

Direct responses from 330+ Cloudflare edge locations worldwide nearest to the visitor.

03 PUT CONTEXT TO WORK

Small steps.
Useful possibilities.

Where this API can fit into your application. Your product controls the decisions that follow.

01 /

Content personalization & regional defaults.

Detect visitor country, timezone, and currency to automatically localize ecommerce, language defaults, and pricing.

02 /

Fraud prevention & risk assessment.

Cross-reference user IP address with VPN, proxy, Tor, and datacenter signals to protect signups, checkout, and account logins.

03 /

Traffic analysis & network logging.

Enrich server logs and analytics pipelines with structured ASN, organization, and connection context without high latency overhead.

04 MADE FOR YOUR WORKFLOW

Your integration.
A straightforward start.

Choose an endpoint, subscribe, and connect your application key right in the request builder.

Endpoint documentation

GET /v1/ip

Lookup IP Geolocation and Network Intelligence

Lookup geolocation coordinates, city, country, ASN, ISP, timezone, and risk/VPN status for IPv4 or IPv6.

Parameters

ipOptional
query · string

The IPv4 or IPv6 address to lookup. If omitted, resolves caller IP.

Integration facts

  • No provider credentials are exposed to you
  • Requests are metered against your plan
  • Captured bodies are encrypted and kept 7 days

AI & Coding Agents

One-click MCP & llms.txt

The PayloadAPI Edge Gateway automatically bridges this API into a JSON-RPC 2.0 MCP server at /ip-geolocation-api/v1/mcp. Tool discovery (initialize, tools/list) is quota-free; tools/call executions meter against your active plan.

View /apis/ip-geolocation-api/llms.txt
Add to .cursor/mcp.json
{
  "mcpServers": {
    "payloadapi-ip-geolocation-api": {
      "url": "https://gateway.payloadapi.com/ip-geolocation-api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:PAYLOADAPI_KEY}"
      }
    }
  }
}

Synthesized MCP tools (2)

get_api_v1_checkgeoipGET /api/v1/checkgeoip
No required parameters

MCP tool — Check GeoIP (Legacy Compatibility)

get_v1_ipGET /v1/ip
No required parameters

MCP tool — Lookup IP Geolocation and Network Intelligence

Live request

Request builder

Your first request starts here

Try Edge IP Geolocation API with a free account.

500 free requests per application · monthly allowance. Create an account, connect an application, and activate your plan right here.

No payment details needed for this free allowance.

This endpoint does not accept a request body.

Sending calls the gateway for real: it authenticates your key, counts the request against your plan, and returns whatever the provider returns.

curl --request GET 'https://gateway.payloadapi.com/ip-geolocation-api/v1/ip' --header "Authorization: Bearer $PAYLOADAPI_KEY" --header 'Content-Type: application/json' --header 'X-Payload-Trace: enabled'

Streamed response

Response

Send a request to inspect status, headers, timing, cost, and streamed body chunks.

05 A PLAN FOR YOUR NEXT STEP

Start with the right plan.

Choose a plan for your application. New here? Create your first application and get its API key as part of setup, right on this page.

LIVE PLAN01

Pay-As-You-Go

$0.0002USD · default rate per request
  • No included allowance published
  • No recurring fee
  • $0.0002 USD default usage rate per request
LIVE PLAN02

Free

$0.00USD · Free allowance
  • 500 requests per application
  • Monthly allowance · subscription anniversary
  • No payment or overage charges

Prices are shown in each plan’s published currency. Default usage rates can be overridden for individual endpoints.

DO THE NUMBERS

A quick usage estimate.

Based on Pay-As-You-Go’s default rate. Endpoint-specific rates and taxes are not included.

$2.00USD estimated usage

06 GOOD TO KNOW

The details
before you begin.

Trust breakdown (0/100)View signals
  • Upstream safety0 / 30 ptsNeeds attention

    No evidence recorded.

  • Specification completeness0 / 25 ptsNeeds attention

    No evidence recorded.

  • Duplicate protection0 / 20 ptsNeeds attention

    No evidence recorded.

  • Provenance & standing0 / 25 ptsNeeds attention

    No evidence recorded.

How do I get started?

Choose an available plan here. Select an existing application or create your first one during setup, save its API key, and activate your plan. Then use the key in the request builder. Requests call the gateway for real and count against your plan.

Do free requests reset every month?

Check the allowance period on each plan. A one-time allowance does not reset. A monthly free allowance renews on the subscription anniversary. Free allowances are per application.

What data does the IP Geolocation API return?

Responses provide structured JSON containing country, region, city, postal code, latitude, longitude, timezone, currency, calling code, ASN, ISP, organization, and proxy/VPN risk signals.

Can IP geolocation identify someone’s exact physical street address?

No. IP geolocation estimates a geographic area such as a city, region, or country based on telecom network routing. It does not reveal a street address or individual personal identity.

How is sub-millisecond edge latency achieved?

The API is deployed on Cloudflare’s global edge network across 330+ data centers. Requests are answered directly from the data center closest to the requester, eliminating distance round-trips to an origin server.

Why are some plans unavailable for activation?

Their published pricing is available for comparison. Free allowances can be activated here; commercial plans with active checkout can be purchased. Custom enterprise tiers require contacting the provider directly.

What does the trust score tell me?

The score summarizes recorded catalog verification checks. Review the breakdown for individual signals; it is not an uptime or performance guarantee.

Back to top ↑