Name

GoogleHack::Search - this is a very simple interface to the Google API. It makes it easier for querying Google.

SYNOPSIS

 use GoogleHack::Search;
 my $search = GoogleHack::Search->new();
 $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.

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.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

PACKAGE METHODS

__PACKAGE__->new(\%args)

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

__PACKAGE__->init(\%args)

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

Valid arguments are :

• key

  string. key to the google-api

• File_location

  string. This the wsdl file name

• adverbs_list

  string. The location of the adverbs list file

• verbs_list

  string. The location of the verbs list file

• adjectives_list

  string. The location of the adjectives list file

• nouns_list

  string. The location of the nouns list file

• stop_list

  string. The location of the stop_words list file

__PACKAGE__->setMaxResults(\%args)

Purpose: This this function can used to set the maximum number of results retrieved.

Valid arguments are :

• maxResults

  number. Number of results you want to be able to retrieve .

__PACKAGE__->setlr(\%args)

Purpose: This this function can used to set the language restriction

Valid arguments are :

• lr

  string. Language Restricion eg lang_eng

__PACKAGE__->setoe(\%args)

Purpose: This this function can used to set oe

Valid arguments are :

• oe

  string.

__PACKAGE__->setie(\%args)

Purpose: This this function can used to set ie

Valid arguments are :

• ie

  string.

__PACKAGE__->setStartPos(\%args)

Purpose: This function sets the startposition for the search results

Valid arguments are :

• StartPos

  string.

__PACKAGE__->setFilter(\%args)

Purpose: This functions sets the search filter as on or off

Valid arguments are :

• Filter

  boolean. True or False

__PACKAGE__->setRestrict(\%args)

Purpose: this funciton restricts the search to a specific domains

Valid arguments are :

• Restrict

  String. UncleSam for the US Government

__PACKAGE__->setSafeSearch(\%args)

Purpose: This functions enables safe search, Restricts search to non-abusive material.

Valid arguments are :

• Restrict

  Boolean. "True" or "False".

__PACKAGE__->Search(\%args)

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(\%args)

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(\%args)

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(\%args)

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

No Valid arguments.

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