The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.


WWW::Google::PageRank - Query google pagerank of page


 use WWW::Google::PageRank;
 my $pr = WWW::Google::PageRank->new;
 print scalar($pr->get('')), "\n";


The WWW::Google::PageRank is a class implementing a interface for querying google pagerank.

To use it, you should create WWW::Google::PageRank object and use its method get(), to query page rank of URL.

It uses LWP::UserAgent for making request to Google.


$gpr = WWW::Google::PageRank->new(%options);

This method constructs a new WWW::Google::PageRank object and returns it. Key/value pair arguments may be provided to set up the initial state. The following options correspond to attribute methods described below:

   KEY                     DEFAULT
   -----------             --------------------
   agent                   "Mozilla/4.0 (compatible; GoogleToolbar 2.0.111-big; Windows XP 5.1)"
   proxy                   undef
   timeout                 undef
   env_proxy               undef
   host                    ""

agent specifies the header 'User-Agent' when querying Google. If the proxy option is passed in, requests will be made through specified poxy. proxy is the host which serve requests from Googlebar.

If the env_proxy option is passed in with a TRUE value, then proxy settings are read from environment variables (see LWP::UserAgent::env_proxy)


$pr = $gpr->get('');

Queries Google for a specified pagerank URL and returns pagerank. If query successfull, integer value from 0 to 10 returned. If query fails for some reason (google unreachable, url does not begin from 'http://', undefined url passed) it return undef.

In list context this function returns list from two elements where first is the result as in scalar context and the second is the HTTP::Response object (returned by LWP::UserAgent::get). This can be usefull for debugging purposes and for querying failure details.


If you find any, please report ;)


Yuri Karaban <>.

Algorithm of computing checksum taken from mozilla module pagerankstatus by Stephane Queraud <>.

Algorithm was modified (15-09-2004) according to new algorithm of computingchecksum in googlebar.


Copyright 2004-2011, Yuri Karaban, All Rights Reserved.

You may use, modify, and distribute this package under the same terms as Perl itself.