NAME

       Net::Google::SafeBrowsing2::Lookup - Perl extension for the Google Safe Browsing v2 Lookup API.

SYNOPSIS

         use Net::Google::SafeBrowsing2::Lookup;

         my $gsb = Net::Google::SafeBrowsing2::Lookup->new(
               key     => "my key",
         );

         my %match = $gsb->lookup(url => 'http://www.gumblar.cn/');

         if ($match{'http://www.gumblar.cn/'} eq 'malware') {
               print "http://www.gumblar.cn/ is flagged as a dangerous site\n";
         }

         my %matches = $gsb->lookup(urls => ['http://www.gumblar.cn/', 'http://flahupdate.co.cc']);
         foreach my $url (keys %matches) {
           print $url, " is ", $matches{$url}, "\n";
         }

DESCRIPTION

       Net::Google::SafeBrowsing2::Lookup implements the Google Safe Browsing v2 Lookup API. See the API
       documentation at <http://code.google.com/apis/safebrowsing/lookup_guide.html>.

       If you need to check more than 10,000 URLs a day, you need to use Net::Google::SafeBrowsing2.

       The source code is available on github at https://github.com/juliensobrier/Net-Google-SafeBrowsing2
       <https://github.com/juliensobrier/Net-Google-SafeBrowsing2>.

CONSTRUCTOR

   new()
       Create a Net::Google::SafeBrowsing2::Lookup object

         my $gsb = Net::Google::SafeBrowsing2::Lookup->new(
               key     => "my key",
               debug   => 0,
         );

       Arguments

       key Required. Your Google Safe Browsing API key

       debug
           Optional. Set to 1 to enable debugging. 0 (disabled) by default.

           The debug output maybe quite large and can slow down significantly the update and lookup functions.

       errors
           Optional. Set to 1 to show errors to STDOUT. 0 (disabled by default).

       version
           Optional. Google Safe Browsing version. 3.0 by default

       delay
           Optional.  Delay,  in seconds, between 2 requests to the Google server. See the "lookup" function for
           more details. 0 (no delay) by default

PUBLIC FUNCTIONS

   lookup()
       Lookup a list URLs against the Google Safe Browsing v2 lists.

         my %match = $gsb->lookup(url => 'http://www.gumblar.cn');

       Returns a hash "url" => "Google match". The possible list of values for  "Google  match"  are:  "ok"  (no
       match), "malware", "phishing", "malware,phishing" (match both lists) and "error".

       Arguments

       url Optional. Single URL to lookup.

       urls
           Optional. List of URLs to lookup.

           The   Lookup   API   allows   only   10,000   URL   checks   a   day.  if  you  need  more,  use  the
           Net::Google::SafeBrowsing2 library.

           Each requests must contain 500 URLs at most. The lookup() method will  split  the  list  of  URLS  in
           blocks of 500 URLs if needed.

       delay
           Optional.  If  more  than  500 URLs are checked, wait "delay" seconds between consecutive requests to
           avoid rate limiting by Google.

CHANGELOG

       0.2 Documentation update.

SEE ALSO

       See Net::Google::SafeBrowsing2 for the implementation of Google Safe Browsing v2 API.

AUTHOR

       Julien Sobrier, <jsobrier@zscaler.com> or <julien@sobrier.net>

COPYRIGHT AND LICENSE

       Copyright (C) 2012 by Julien Sobrier

       This library is free software; you can redistribute it and/or modify it under  the  same  terms  as  Perl
       itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.

perl v5.14.2                                       2013-05-11             Net::Google::Sa...owsing2::Lookup(3pm)