API Reference

const res  = await fetch('https://ipfly.world/api?token=YOUR_TOKEN&ip=8.8.8.8');
if (!res.ok) throw new Error(`IPFly error: ${res.status}`);
const data = await res.json();

console.log(data.country_name);      // "United States"
console.log(data.city);              // "Mountain View"
console.log(data.security.is_vpn);   // false
console.log(data.currency.symbol);   // "$"

// Native fetch, no dependencies needed on Node 18+
async function lookupIP(ip) {
  const url = new URL('https://ipfly.world/api');
  url.searchParams.set('token', process.env.IPFLY_TOKEN);
  if (ip) url.searchParams.set('ip', ip);

  const res = await fetch(url);
  if (!res.ok) throw new Error(`IPFly ${res.status}`);
  return res.json();
}

const geo = await lookupIP('8.8.8.8');
console.log(geo.country_name, geo.asn.name);

<?php
$url  = 'https://ipfly.world/api?token=' . urlencode($_ENV['IPFLY_TOKEN']) . '&ip=8.8.8.8';
$ctx  = stream_context_create(['http' => ['timeout' => 5]]);
$json = @file_get_contents($url, false, $ctx);

if ($json === false) {
    // network-level failure — fail open
    exit;
}

$data = json_decode($json, true);
if (isset($data['error'])) {
    error_log('IPFly error: ' . $data['error']['code']);
    exit;
}

echo $data['country_name'];         // "United States"
echo $data['security']['is_vpn'];   // false

import os
import requests

def lookup_ip(ip: str | None = None, timeout: float = 5.0) -> dict:
    params = {"token": os.environ["IPFLY_TOKEN"]}
    if ip:
        params["ip"] = ip
    r = requests.get("https://ipfly.world/api", params=params, timeout=timeout)
    r.raise_for_status()
    return r.json()

data = lookup_ip("8.8.8.8")
print(data["city"], data["asn"]["name"])   # Mountain View Google LLC

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

var client  = HttpClient.newBuilder()
    .connectTimeout(Duration.ofSeconds(5))
    .build();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://ipfly.world/api?token=" + System.getenv("IPFLY_TOKEN") + "&ip=8.8.8.8"))
    .timeout(Duration.ofSeconds(5))
    .build();

var response = client.send(request, HttpResponse.BodyHandlers.ofString());
if (response.statusCode() != 200) {
    throw new RuntimeException("IPFly error: " + response.statusCode());
}
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://ipfly.world/api")
uri.query = URI.encode_www_form(token: ENV['IPFLY_TOKEN'], ip: '8.8.8.8')

response = Net::HTTP.get_response(uri)
data     = JSON.parse(response.body)

raise "IPFly error: #{data['error']['code']}" if data['error']

puts data['country_name']
puts data['security']['is_vpn']

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
    "os"
    "time"
)

func main() {
    q := url.Values{}
    q.Set("token", os.Getenv("IPFLY_TOKEN"))
    q.Set("ip", "8.8.8.8")

    client := &http.Client{Timeout: 5 * time.Second}
    resp, err := client.Get("https://ipfly.world/api?" + q.Encode())
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var data map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&data)
    fmt.Println(data["country_name"])
}