Geo API - Reverse America Developer Tools

« Back to the developer index

The Geo API

The Geo API provides a simple way to find the location of a phone number. Results are given with their estimated level of accuracy, either 'accurate', 'questionable', 'best guess', or 'general area' based on factors such as record age, or whether a known record was used to find the result.

The request to our API is a standard HTTP GET request as follows:

http://api.reverseamerica.co/geolookup.php?format=FORMAT&key=APIKEY&q=PHONE

Parameters

format (required)

valid options are json, xml, text


key (required)

32 characters long, provided when you join the developer program


q (required)

valid America phone number


Example Query Results

Text

http://api.reverseamerica.co/geolookup.php?format=text&key=EXAMPLE&q=0292061111
result (tab separated)
(02) 9206 1111 \t questionable \t Sydney \t NSW \t 2000 \t Telstra Corporation Limited \t Sydney \t Local Service

JSON

http://api.reverseamerica.co/geolookup.php?format=json&key=EXAMPLE&q=0292061111
result
{"phone":"(02) 9206 1111","match":"questionable","suburb":"Sydney","state":"NSW","zip":"2000","holder":"Telstra Corporation Limited","area":"Sydney","type":"Local Service"}

XML

http://api.reverseamerica.co/geolookup.php?format=xml&key=EXAMPLE&q=0292061111
result
<?xml version="1.0" encoding="iso-8859-1"?><record><phone>(02) 9206 1111</phone><match>questionable</match><suburb>Sydney</suburb><state>NSW</state><zip>2000</zip><holder>Telstra Corporation Limited</holder><area>Sydney</area><type>Local Service</type></record>


API Support

Please contact support@reverseamerica.co if you are having trouble implementing our API