IP Geolocation API

Getting Started

Our API offers a generous free tier that requires no authentication. For higher limits and premium features, you'll need an API key which can be obtained through our router login system.

How to Get an API Key

Using Your API Key

Include your API key in requests using the X-API-Key header:

curl -H "X-API-Key: your_api_key_here" https://whatismyip.io/api/ipinfo

const response = await fetch('https://whatismyip.io/api/ipinfo', {
  headers: {
    'X-API-Key': 'your_api_key_here'
  }
});
const data = await response.json();

import requests

headers = {'X-API-Key': 'your_api_key_here'}
response = requests.get('https://whatismyip.io/api/ipinfo', headers=headers)
data = response.json()

cURL

# Get your own IP info
curl https://whatismyip.io/api/ipinfo

# Get specific IP info
curl https://whatismyip.io/api/ipinfo?ip=8.8.8.8

# With API key (for higher limits)
curl -H "X-API-Key: your_api_key" https://whatismyip.io/api/ipinfo

JavaScript

// Fetch API
const response = await fetch('https://whatismyip.io/api/ipinfo');
const data = await response.json();
console.log(data);

// With specific IP
const response = await fetch('https://whatismyip.io/api/ipinfo?ip=8.8.8.8');
const data = await response.json();
console.log(data.location.city);

Python

import requests

# Get IP info
response = requests.get('https://whatismyip.io/api/ipinfo')
data = response.json()
print(f"Your IP: {data['ip']}")
print(f"Location: {data['location']['city']}, {data['location']['country']}")

# With specific IP
response = requests.get('https://whatismyip.io/api/ipinfo?ip=8.8.8.8')
data = response.json()
print(data)

PHP

<?php
// Get IP info
$response = file_get_contents('https://whatismyip.io/api/ipinfo');
$data = json_decode($response, true);

echo "Your IP: " . $data['ip'] . "\n";
echo "Location: " . $data['location']['city'] . ", " . $data['location']['country'] . "\n";

// With cURL for more control
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://whatismyip.io/api/ipinfo?ip=8.8.8.8');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, array('X-API-Key: your_api_key'));
$result = curl_exec($ch);
curl_close($ch);
?>

Node.js

const axios = require('axios');

// Using axios
async function getIPInfo(ip = '') {
  try {
    const url = ip ? 
      `https://whatismyip.io/api/ipinfo?ip=${ip}` : 
      'https://whatismyip.io/api/ipinfo';
    
    const response = await axios.get(url, {
      headers: { 'X-API-Key': 'your_api_key' }
    });
    
    return response.data;
  } catch (error) {
    console.error('Error:', error.message);
  }
}

getIPInfo('8.8.8.8').then(data => console.log(data));

Go

package main

import (
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    resp, err := http.Get("https://whatismyip.io/api/ipinfo")
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    
    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }
    
    var data map[string]interface{}
    json.Unmarshal(body, &data)
    fmt.Printf("IP: %s\n", data["ip"])
}