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);


    #If required you can set search parameters with following functions:

    #$search->setMaxResults($param);
    #$search->setlr($param);
    #$search->setoe($param);
    #$search->setie($param);
    #$search->setStartPos($param);
    #$search->setFilter("bool");
    #$search->setSafeSearch("bool");
    #$search->setRestrict("bool");

DESCRIPTION

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

PACKAGE METHODS

__PACKAGE__->new()

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

__PACKAGE__->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

__PACKAGE__->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.

__PACKAGE__->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..

__PACKAGE__->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.

__PACKAGE__->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

Pratheepan Raveendranathan

Ted Pedersen

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

COPYRIGHT AND LICENSE

Copyright (c) 2003 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.