Documentation

ipdata.co provides a JSON IP Address Geolocation API that allows you to lookup the location of any IP address, both IPv4 and IPv6.
Getting Started
The simplest call you can make would be a parameter-less GET call to the API endpoint at https://api.ipdata.co. This would return the location of the calling IP address.
curl https://api.ipdata.co?api-key=test
To lookup a specific IP Address
curl https://api.ipdata.co/8.8.8.8?api-key=test
More Examples
Javascript
Python
Node
PHP
Ruby
Go
C#
Java
Swift
Javascript
var request = new XMLHttpRequest();
​
request.open('GET', 'https://api.ipdata.co/?api-key=test');
​
request.setRequestHeader('Accept', 'application/json');
​
request.onreadystatechange = function () {
  if (this.readyState === 4) {
    console.log(this.responseText);
  }
};
​
request.send();
Python
from ipdata import ipdata
from pprint import pprint
​
# Create an instance of an ipdata object. Replace `test` with your API Key
ipdata = ipdata.IPData('test')
response = ipdata.lookup('69.78.70.144')
pprint(response)
Node
const IPData = require('ipdata').default;
const ipdata = new IPData('test');
​
ipdata.lookup()
  .then(function(info) {
    console.log(info)
  });
PHP
use Ipdata\ApiClient\Ipdata;
use Symfony\Component\HttpClient\Psr18Client;
use Nyholm\Psr7\Factory\Psr17Factory;
​
$httpClient = new Psr18Client();
$psr17Factory = new Psr17Factory();
$ipdata = new Ipdata('test', $httpClient, $psr17Factory);
$data = $ipdata->lookup('69.78.70.144');
echo json_encode($data, JSON_PRETTY_PRINT);
Ruby
require 'uri'
require 'net/http'
​
url = URI("https://api.ipdata.co/?api-key=test")
​
http = Net::HTTP.new(url.host, url.port)
​
request = Net::HTTP::Get.new(url)
​
response = http.request(request)
puts response.read_body
Go
package main
​
import (
	"fmt"
	"net/http"
	"io/ioutil"
)
​
func main() {
​
	url := "https://api.ipdata.co/?api-key=test"
​
	req, _ := http.NewRequest("GET", url, nil)
​
	res, _ := http.DefaultClient.Do(req)
​
	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)
​
	fmt.Println(res)
	fmt.Println(string(body))
​
}
C#
var client = new RestClient("https://api.ipdata.co/?api-key=test");
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);
Java
import io.ipdata.client.Ipdata;
​
URL url = new URL("https://api.ipdata.co");
IpdataService ipdataService = Ipdata.builder().url(url)
      .key("test").get();
IpdataModel model = ipdataService.ipdata("1.1.1.1");
System.out.println(jsonSerialize(model));
Swift
import Foundation
​
let request = NSMutableURLRequest(url: NSURL(string: "https://api.ipdata.co/?api-key=test")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
​
let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})
​
dataTask.resume()
All calls must be made to the https endpoint. No requests will be served over unsecured HTTP.
 Make sure to sign up for a Free API key here to test these examples.
The test API key used in these examples is very limited and very heavily rate limited and is meant only for a few initial tests.
Next - Guides
Mobile Carrier Detection
Last updated 3 weeks ago