🔗

IP Geolocation API in cURL

Complete cURL integration guide for the IP Geolocation API. Copy the code below, add your RapidAPI key, and start building.

🐍 Python ⚡ JavaScript 🔗 cURL 🐘 PHP 💎 Ruby 🔵 Go ☕ Java 🟣 C#

Prerequisites

1.Sign up for a free account on RapidAPI
2.Subscribe to the IP Geolocation API (free tier available)
3.Copy your X-RapidAPI-Key from the dashboard

Complete cURL Example

helix-ip-geolocation.sh

curl -X GET "https://ip-geolocation-by-helix-api.p.rapidapi.com/lookup/8.8.8.8" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: ip-geolocation-by-helix-api.p.rapidapi.com"

Response Format

All Helix-API endpoints return a consistent JSON envelope:

{
  "status": "ok",
  "data": { ... },
  "meta": {
    "request_id": "req_abc123",
    "latency_ms": 42
  }
}

On errors, status becomes "error" and a message field explains what went wrong.

Error Handling

Status	Meaning	Action
`200`	Success	Parse the response body normally
`400`	Bad request	Check your request parameters
`401`	Unauthorized	Verify your X-RapidAPI-Key header
`429`	Rate limited	Wait and retry with exponential backoff
`500`	Server error	Retry after a short delay

cURL Best Practices

Perfect for quick testing

cURL is the fastest way to test the IP Geolocation API from your terminal. Copy the example above and replace YOUR_API_KEY.

Pipe output to jq

Add | jq '.' to pretty-print JSON responses, or | jq '.data' to extract specific fields.

Save to a file

Add -o response.json to save the output directly to a file. Great for logging and debugging.

Use environment variables for keys

Set export RAPIDAPI_KEY="your_key" and reference it with $RAPIDAPI_KEY in your curl commands. Never hardcode keys in scripts.

IP Geolocation API Endpoints

GET

/lookup/{ip}

Full geolocation for an IP

GET

/lookup/me

Lookup caller's IP

POST

/bulk

Lookup up to 20 IPs

Other Languages

View the IP Geolocation API integration guide in another language:

🐍 Python ⚡ JavaScript 🐘 PHP 💎 Ruby 🔵 Go ☕ Java 🟣 C#

Related APIs

QR Code API

Generate beautiful QR codes instantly

cURL guide →

URL Shortener API

Shorten, track, and manage URLs at scale