Geo API v2 - Reverse South Africa Developer Tools

« Back to the developer index

The Geo API v2

The Geo API provides a simple way to find the location of a phone number. Results are given with their estimated level of confidence based on factors such as record age, and number distribution within a geographic location.

If available, the exact address of the location is given. Otherwise, where available, the location is calculated based on the geographic centerpoint of known records within the phone prefix. For example 0262195555 becomes 02621955XX, then 0262195XXX, and finally 026219XXXX. All results attempt to provide a latitude and longitude of the centerpoint.

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

http://api.reversesouthafrica.com/geolookup-v2.php?format=FORMAT&key=APIKEY&q=PHONE

Parameters

format (required)

valid options are json, xml, phps. Due to the extended output of this API, text is not a supported format.


key (required)

32 characters long, provided when you join the developer program


q (required)

valid South Africa phone number


Example Query Results

JSON

http://api.reversesouthafrica.com/geolookup-v2.php?format=json&key=EXAMPLE&q=0262195555
result
{"exact":{"formatted":"College St, Canberra ACT 2617, Australia","lat":-35.2424748,"lng":149.0773466,"confidence":"0%"},"XX":{"mask":"02621955XX","confidence":"5%","lat":-35.242475,"lng":149.077347,"geo":{"street":"Tourist Drive 4","suburb":"Bruce","state":"ACT","country":"Australia","zip":"2617","formatted":"Tourist Drive 4, Bruce ACT 2617, Australia"}},"XXX":{"mask":"0262195XXX","confidence":"28%","lat":-35.226951,"lng":149.077744,"geo":{"suburb":"Lawson","state":"ACT","country":"Australia","zip":"2617","formatted":"Lawson ACT 2617, Australia"}},"XXXX":{"mask":"026219XXXX","confidence":"35%","lat":-35.183079,"lng":149.136214,"geo":{"suburb":"Gungahlin","state":"ACT","country":"Australia","zip":"2912","formatted":"Gungahlin ACT 2912, Australia"}},"phone":"(02) 6219 5555"}

XML

http://api.reversesouthafrica.com/geolookup-v2.php?format=xml&key=EXAMPLE&q=0262195555
result
<?xml version="1.0" encoding="iso-8859-1"?><record><exact><formatted>College St, Canberra ACT 2617, Australia</formatted><lat>-35.2424748</lat><lng>149.0773466</lng><confidence>0%</confidence></exact><XX><mask>02621955XX</mask><confidence>5%</confidence><lat>-35.242475</lat><lng>149.077347</lng><geo><street>Tourist Drive 4</street><suburb>Bruce</suburb><state>ACT</state><country>Australia</country><zip>2617</zip><formatted>Tourist Drive 4, Bruce ACT 2617, Australia</formatted></geo></XX><XXX><mask>0262195XXX</mask><confidence>28%</confidence><lat>-35.226951</lat><lng>149.077744</lng><geo><suburb>Lawson</suburb><state>ACT</state><country>Australia</country><zip>2617</zip><formatted>Lawson ACT 2617, Australia</formatted></geo></XXX><XXXX><mask>026219XXXX</mask><confidence>35%</confidence><lat>-35.183079</lat><lng>149.136214</lng><geo><suburb>Gungahlin</suburb><state>ACT</state><country>Australia</country><zip>2912</zip><formatted>Gungahlin ACT 2912, Australia</formatted></geo></XXXX><phone>(02) 6219 5555</phone></record>

PHPS

http://api.reversesouthafrica.com/geolookup-v2.php?format=phps&key=EXAMPLE&q=0262195555
result
a:5:{s:5:"exact";a:4:{s:9:"formatted";s:40:"College St, Canberra ACT 2617, Australia";s:3:"lat";d:-35.242474799999996548649505712091922760009765625;s:3:"lng";d:149.07734659999999848878360353410243988037109375;s:10:"confidence";s:2:"0%";}s:2:"XX";a:5:{s:4:"mask";s:10:"02621955XX";s:10:"confidence";s:2:"5%";s:3:"lat";d:-35.2424749999999988858689903281629085540771484375;s:3:"lng";d:149.077347000000003163222572766244411468505859375;s:3:"geo";a:6:{s:6:"street";s:15:"Tourist Drive 4";s:6:"suburb";s:5:"Bruce";s:5:"state";s:3:"ACT";s:7:"country";s:9:"Australia";s:3:"zip";s:4:"2617";s:9:"formatted";s:42:"Tourist Drive 4, Bruce ACT 2617, Australia";}}s:3:"XXX";a:5:{s:4:"mask";s:10:"0262195XXX";s:10:"confidence";s:3:"28%";s:3:"lat";d:-35.2269509999999996807673596777021884918212890625;s:3:"lng";d:149.07774399999999559440766461193561553955078125;s:3:"geo";a:5:{s:6:"suburb";s:6:"Lawson";s:5:"state";s:3:"ACT";s:7:"country";s:9:"Australia";s:3:"zip";s:4:"2617";s:9:"formatted";s:26:"Lawson ACT 2617, Australia";}}s:4:"XXXX";a:5:{s:4:"mask";s:10:"026219XXXX";s:10:"confidence";s:3:"35%";s:3:"lat";d:-35.18307899999999932560967863537371158599853515625;s:3:"lng";d:149.1362139999999953943188302218914031982421875;s:3:"geo";a:5:{s:6:"suburb";s:9:"Gungahlin";s:5:"state";s:3:"ACT";s:7:"country";s:9:"Australia";s:3:"zip";s:4:"2912";s:9:"formatted";s:29:"Gungahlin ACT 2912, Australia";}}s:5:"phone";s:14:"(02) 6219 5555";}


API Support

Please contact support@reversesouthafrica.com if you are having trouble implementing our API