URL: http://extension.locality.co.za/api/0.1/domains/domains-list.[data_format]
Formats: json, php
Method(s): GET
Parameters:

1. ip (string) [optional] Filter domains by IP address, in dot quad format.
2. since (integer) [optional] Filter domains by discovery date, in UNIX timestamp format.

Response:

1. domains (array) The container array for the domain list, each item key is the domain name.
2. > ip (integer) The IP address of the domain as defined in its DNS record.
3. > timestamp (integer) The UNIX timestamp of when the domain was first added to our database.

Example:

1. Request: http://extension.locality.co.za/api/0.1/domains/domains-list.json?ip=196.220.58.66
2. Response:

   {
     error_msg: null,
     error_type: null,
     response: {
       domains: {
         bt.co.za: {
           ip: -992200126,
           timestamp: 1269878043
         },
         webafrica.co.za: {
           ip: -992200126,
           timestamp: 1267103691
         },
         www.webafrica.co.za: {
           ip: -992200126,
           timestamp: 1262698263
         }
       }
     },
     timestamp: 1234567890
   }

Important Note:

Please make considerable use of the since parameter to ensure only uncached data is requested. Our servers recursively update each domains IP address on a weekly basis, so full requests should not exceed a weekly frequency. IP addresses seen abusing the system will be null routed.