More than 1734 benchmarks completed!
Follow us on twitter

API Access

PetaByet GeoIP & JsonIP REST API (now with IPv6 support!)


PetaByet offers a free GeoIP & JsonIP API to developers for their projects.
The output is JSON (JavaScript Object Notation) which can be integrated into anything.
We offer this service for free public use (both commercial/non-commercial) and an optional link back is appreciated.

API End Points
Last updated: 29 December 2019

GeoIP API Usage

Get GeoIP data of your IP:

Get information about a specific IP address:{ip-address}

Example GeoIP Output

Below you can find the output of our API server:

GET /geoip/
  "ip": "",
  "continent_code": "NA",
  "country": "United States",
  "country_code": "US",
  "country_code3": "USA",
  "region": "North Carolina",
  "region_code": "NC",
  "city": "Charlotte",
  "postal_code": "28202",
  "latitude": 35.2316,
  "longitude": -80.8428,
  "timezone": "America/New_York",
  "offset": -14400,
  "asn": 7489,
  "organization": "HostUS"


This product includes GeoLite2 data created by MaxMind, available from

JsonIP API Usage

Get your IP address:

JsonIP Example Output

GET /jsonip/

Simple IP

Get your IP address in plain text

GET /ip/

Error Output

When an error occurs (eg. Bad input), an error message will be presented.

HTTP: 400 (Bad Request)
JSON Response:
GET /geoip/1.0
	"code": 400,
	"errormessage": "You did not enter a valid IP address"