README

Official PHP client for ipdata.info — a free, fast IP geolocation, ASN, and threat-intelligence API. Look up country, city, ASN, timezone, currency, and security flags (proxy/VPN/Tor/hosting) for any IPv4 or IPv6 address. Powered by ipdata.info.

Get a free API key

The public endpoint is free — 50 requests/min, no signup, no key. For higher rate limits and batch lookups, create a free API key at ipdata.info/register and manage it in your dashboard.

Install

composer require ipdatainfo/sdk

Quickstart

<?php

require 'vendor/autoload.php';

use IPDataInfo\Client;

$client = new Client(); // free tier; or new Client('YOUR_API_KEY')

$info = $client->lookup('8.8.8.8');
echo "{$info['city']}, {$info['country']} ({$info['asn_org']})\n"; // Mountain View, United States (Google LLC)

Methods

Full response schema: ipdata.info API docs · SDK list.

Configuration

new Client(
    apiKey: 'YOUR_API_KEY',      // sent as X-Api-Key; switches to pro.ipdata.info
    baseUrl: 'https://ipdata.info', // optional override
    timeout: 10.0,                  // seconds
);

Errors from non-2xx responses are thrown as IPDataInfo\IpDataException with getStatusCode() and a message from the API's {"error": "..."} body.

Rate limits

• Free (ipdata.info): 50 req/min, no key.
• Paid (pro.ipdata.info): higher limits + batch, with an API key.

Other SDKs

12 official SDKs — see the full list at ipdata.info/docs/sdks: Python, Node.js, Go, PHP, Java, Rust, .NET, Kotlin, Swift, Dart, Bash, Objective-C.

License

MIT © ipdata.info