IPGrabber API reference

  • API URL
  • http://ip.bseolized.com
    Supports both GET and POST requests.
    API token must be passed in the 'token' variable.
    /check_ip/<IP>
  • Checks IP agains spider database.
    Returns JSON response containing is_spider: 1 or 0
  • http://ip.bseolized.com/check_ip/66.249.79.81?token=YOUR_TOKEN_HERE
    {"is_spider":1}
    http://ip.bseolized.com/check_ip/12.34.56.78?token=YOUR_TOKEN_HERE
    {"is_spider":0}
    PHP code example:
    <?php
      $ipg = json_decode(file_get_contents("http://ip.bseolized.com/check_ip/".$_SERVER['REMOTE_ADDR']."?token=YOUR_TOKEN_HERE"), TRUE);
      if ($ipg['is_spider']) {
      	echo "Spider detected";
      } else {
      	echo "Not a spider";
      }
    ?>
    		
    /getlist?format=<json|txt>
  • Retrieve spider IP database in JSON or TXT format
  • http://ip.bseolized.com/getlist?token=YOUR_TOKEN_HERE&format=json
    {"ips":
      [
        {"address":"100.43.80.135","ua":"Mozilla\/4.0 (compatible; MSIE 8.0; Windows NT 6.0; Trident\/4.0; SLCC1; .NET CLR 2.0.50727; .NET CLR 3.5.30729; .NET CLR 3.0.30729)"},
        {"address":"100.43.80.138","ua":"Opera\/9.80 (Windows NT 5.1; U; ru) Presto\/2.6.30 Version\/10.63"},
        {"address":"100.43.80.141","ua":"Mozilla\/4.0 (compatible; MSIE 8.0; Windows NT 6.1; Trident\/4.0; SLCC2; .NET CLR 2.0.50727; .NET CLR 3.5.30729; .NET CLR 3.0.30729; Media Center PC 6.0)"},
        ...
      ]
    }
    http://ip.bseolized.com/getlist?token=YOUR_TOKEN_HERE&format=txt
    100.43.80.135
    100.43.80.138
    100.43.80.141
    ...
    
    PHP code example:
    <?php
      file_put_contents(realpath(dirname(__FILE__)).'/ipgrabber_db.txt',file_get_contents("http://ip.bseolized.com/getlist?token=YOUR_TOKEN_HERE&format=txt"));
    ?>