API Documentation

$ curl "http://ipwho.is/bulk/8.8.4.4,1.1.1.1,2c0f:fb50:4003::"

$ curl --data '["8.8.4.4", "1.1.1.1", "2c0f:fb50:4003::"]' \
     --header "Content-Type: application/json" \
     --request POST "http://ipwho.is/bulk"

{
    "ip": "8.8.4.4",
    "success": true,
    "type": "IPv4",
    "continent": "North America",
    "continent_code": "NA",
    "country": "United States",
    "country_code": "US",
    "region": "California",
    "region_code": "CA",
    "city": "Mountain View",
    "latitude": 37.3860517,
    "longitude": -122.0838511,
    "is_eu": false,
    "postal": "94039",
    "calling_code": "1",
    "capital": "Washington D.C.",
    "borders": "CA,MX",
    flag {
        "img": "https://cdn.ipwhois.io/flags/us.svg",
        "emoji": "🇺🇸",
        "emoji_unicode": "U+1F1FA U+1F1F8"
    },
    connection {
        "asn": 15169,
        "org": "Google LLC",
        "isp": "Google LLC",
        "domain": "google.com"
    },
    timezone {
        "id": "America/Los_Angeles",
        "abbr": "PDT",
        "is_dst": true,
        "offset": -25200,
        "utc": "-07:00",
        "current_time": "2022-04-22T14:31:48-07:00"
    },
    currency {
        "name": "US Dollar",
        "code": "USD",
        "symbol": "$",
        "plural": "US dollars",
        "exchange_rate": 1
    },
    security {
        "anonymous": false,
        "proxy": false,
        "vpn": false,
        "tor": false,
        "hosting": false
    },
    rate {
        "limit": 250000,
        "remaining": 50155
    }
}

{
    [...],
    security {
        "anonymous": true,
        "proxy": false,
        "vpn": true,
        "tor": false,
        "hosting": false,
    }
}

{
    [...],
    rate {
        "limit": 250000,
        "remaining": 50155
    }
}

$ips = ['8.8.8.8', '1.1.1.1', '208.67.222.222'];
$ch = curl_init('https://ipwho.is/bulk');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, false);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($ips));
$data = json_decode(curl_exec($ch), true);
curl_close($ch);
echo $data[0]['ip'] . ': ' . $data[0]['country'] . ' ' . $data[0]['flag']['emoji']; // Example output: 8.8.8.8: United States 🇺🇸

const ips = ['8.8.8.8', '1.1.1.1', '208.67.222.222'];
const url = `https://ipwho.is/bulk`;

fetch(url, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(ips)
})
  .then(res => res.json())
  .then(data => {
    console.log(`${data[0].ip}: ${data[0].country} ${data[0].flag.emoji}`); // Example output: 8.8.8.8: United States 🇺🇸
  });

package main

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

func main() {
  ips := []string{"8.8.8.8", "1.1.1.1", "208.67.222.222"}
  body, _ := json.Marshal(ips)

  url := "https://ipwho.is/bulk"
  req, _ := http.NewRequest("POST", url, bytes.NewReader(body))
  req.Header.Set("Content-Type", "application/json")

  client := &http.Client{}
  resp, _ := client.Do(req)
  defer resp.Body.Close()

  b, _ := io.ReadAll(resp.Body)
  data := []map[string]any{}
  json.Unmarshal(b, &data)

  fmt.Println(data[0]["ip"], data[0]["country"]) // Example output: 8.8.8.8 United States
}

import requests

ips = ['8.8.8.8', '1.1.1.1', '208.67.222.222']
url = 'https://ipwho.is/bulk'

response = requests.post(url, json=ips)
data = response.json()

print(data[0]['ip'], data[0]['country'], data[0]['flag']['emoji']) # Example output: 8.8.8.8 United States 🇺🇸

import java.net.URI;
import java.net.http.*;

public class Main {
  public static void main(String[] args) throws Exception {
    var client = HttpClient.newHttpClient();
    var url = "https://ipwho.is/bulk";

    var body = "[\"8.8.8.8\",\"1.1.1.1\",\"208.67.222.222\"]";

    var request = HttpRequest.newBuilder()
      .uri(URI.create(url))
      .header("Content-Type", "application/json")
      .POST(HttpRequest.BodyPublishers.ofString(body))
      .build();

    var response = client.send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body()); // Output: JSON array
  }
}

require 'net/http'
require 'json'
require 'uri'

ips = ['8.8.8.8', '1.1.1.1', '208.67.222.222']
url = 'https://ipwho.is/bulk'

uri = URI(url)
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

req = Net::HTTP::Post.new(uri)
req['Content-Type'] = 'application/json'
req.body = ips.to_json

res = http.request(req)
data = JSON.parse(res.body)

puts data[0]['ip'] + ': ' + data[0]['country'] + ' ' + data[0]['flag']['emoji'] # Example output: 8.8.8.8: United States 🇺🇸

import Foundation

let url = "https://ipwho.is/bulk"
let ips = ["8.8.8.8", "1.1.1.1", "208.67.222.222"]

var request = URLRequest(url: URL(string: url)!)
request.httpMethod = "POST"
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try? JSONSerialization.data(withJSONObject: ips)

let sem = DispatchSemaphore(value: 0)

URLSession.shared.dataTask(with: request) { data, _, _ in
  guard let data = data else { sem.signal(); return }
  let json = try? JSONSerialization.jsonObject(with: data) as? [[String: Any]]
  let first = json?.first
  let ip = first?["ip"] as? String ?? ""
  let country = first?["country"] as? String ?? ""
  let flag = (first?["flag"] as? [String: Any])?["emoji"] as? String ?? ""
  print(ip, country, flag) // Example output: 8.8.8.8 United States 🇺🇸
  sem.signal()
}.resume()

sem.wait()

use reqwest;
use serde_json::Value;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
  let url = format!("https://ipwho.is/bulk");
  let ips = vec!["8.8.8.8", "1.1.1.1", "208.67.222.222"];

  let data: Value = reqwest::Client::new()
    .post(url)
    .json(&ips)
    .send().await?
    .json().await?;

  println!("{}: {}", data[0]["ip"], data[0]["country"]); // Example output: 8.8.8.8: United States
  Ok(())
}