NAME

WebService::GoogleHack::Search - This module is used to query Google.

SYNOPSIS

  use WebService::GoogleHack::Search;

  #create an object of type search
  my $search = GoogleHack::Search->new();

  #Query Google.
  $search->searchPhrase($searchString);

  #The results variable will now contain the results of your query.

  #Printing the searchtime

  print "\n Search Time".$search->{'searchTime'};

  #Printing the snippet element 0

  print "\n\nSnippet".$search->{'snippet'}->[0];

DESCRIPTION

This module provides a simple interface to the Google API. It is used by the GoogleHack module.

PACKAGE METHODS

_METHOD__->new()

Purpose: This function creates an object of type Search and returns a blessed reference.

_METHOD__->init(key,wsdl_location)

Purpose: This this function can used to inititalize the member variables.

Valid arguments are :

  • key

    string. key to the google-api

  • wsdl_location

    string. This the wsdl file name

_METHOD__->Search(searchString,num_results,integer)

Purpose: This function is used to query googles

Valid arguments are :

  • searchString

    string. Need to pass the search string, which can be a single word or phrase, maximum ten words

  • num_results

    integer. The number of results you wast to retrieve, default is 10. Maximum is 1000. Give in terms of multiples of ten.

Returns: Returns a Search object containing the search results.

_METHOD__->getEstimateNo()

Purpose: This function returns the number of results predicted by google for a specific search term.

No Valid arguments.

Returns: Returns the total number of results for a search string..

_METHOD__->IamFeelingLucky()

Purpose: This function imitates the "I am Feeling Lucky" search feature of Google. It basically returns the URL of the first result of your search.

No Valid arguments.

Returns: Returns the URL of the first result of your search.

_METHOD__->getCachedPage()

Purpose: This function retrieves a cached webpage, given the URL.

No Valid arguments.

Returns: Returns the contents of as web page given a URL.

AUTHOR

Pratheepan Raveendranathan, <rave0029@d.umn.edu>

Ted Pedersen, <tpederse@d.umn.edu>

BUGS

SEE ALSO

GoogleHack home page - http://google-hack.sourceforge.net

Pratheepan Raveendranathan - http://www.d.umn.edu/~rave0029/research

Ted Pedersen - www.d.umn.edu./~tpederse

Google-Hack Maling List <google-hack-users@lists.sourceforge.net>

COPYRIGHT AND LICENSE

Copyright (c) 2005 by Pratheepan Raveendranathan, Ted Pedersen

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to

The Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.