Usage limits

Our system will automatically ban any IP addresses doing over 150 requests per minute. To unban your IP you'll have to sent a email to [email protected]

You are free to use our API for non-commercial and commercial use.

Usage

TTo receive the response in JSON format, send a GET request to

https://api.revplit.com/geo/json/response.php?ip=

You can supply an IP address or domain to lookup.

Response

A successful request will return the following:

{
"status": "success",
"country": "COUNTRY",
"countryCode": "COUNTRY CODE",
"region": "REGION CODE",
"regionName": "REGION NAME",
"city": "CITY",
"zip": "ZIP CODE",
"lat": LATITUDE,
"lon": LONGITUDE,
"timezone": "TIME ZONE",
"isp": "ISP NAME",
"org": "ORGANIZATION NAME",
"as": "AS NUMBER / NAME",
"query": "IP ADDRESS USED FOR QUERY"
}

Error messages

Value Description
private range the IP address is part of a private range More info
reserved range the IP address is part of a reserved range More info
invalid query invalid IP address or domain name

Examples

https://api.revplit.com/geo/json/response.php?ip=208.80.152.201

Response

{
"status": "success",
"country": "United States",
"countryCode": "US",
"region": "CA",
"regionName": "California",
"city": "San Francisco",
"zip": "94105",
"lat": "37.7898",
"lon": "-122.3942",
"timezone": "America\/Los_Angeles",
"isp": "Wikimedia Foundation",
"org": "Wikimedia Foundation",
"as": "AS14907 Wikimedia US network",
"query": "208.80.152.201"
}