Иван Бахчеев > WWW-Yahoo-InboundLinks > WWW::Yahoo::InboundLinks

Download:
WWW-Yahoo-InboundLinks-0.07.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  0
View/Report Bugs
Module Version: 0.07   Source  

NAME ^

WWW::Yahoo::InboundLinks - Tracking Inbound Links in Yahoo Site Explorer API

SYNOPSIS ^

        use WWW::Yahoo::InboundLinks;
        my $ylinks = WWW::Yahoo::InboundLinks->new ('YahooAppId');
        my %params = {
                omit_inlinks => 'domain',
        };
        print $ylinks->get ('http://yahoo.com', %params), "\n";

        # or 

DESCRIPTION ^

The WWW::Yahoo::InboundLinks is a class implementing a interface for Tracking Inbound Links in Yahoo Site Explorer API.

More information here: http://developer.yahoo.com/search/siteexplorer/V1/inlinkData.html

To use it, you should create WWW::Yahoo::InboundLinks object and use its method get(), to query inbound links for url.

It uses LWP::UserAgent for making request to Yahoo and JSON for parsing response.

METHODS ^

my $ylinks = WWW::Yahoo::InboundLinks->new ('YahooAppId');

This method constructs a new WWW::Yahoo::InboundLinks object and returns it. Required parameter — Yahoo Application Id (http://developer.yahoo.com/faq/index.html#appid)

my $ua = $ylinks->user_agent;

This method returns constructed LWP::UserAgent object. You can configure object before making requests.

my $count = $ylinks->get ('http://yahoo.com', %params);

Queries Yahoo about inbound links for a specified url. Parameters similar to params on this http://developer.yahoo.com/search/siteexplorer/V1/inlinkData.html page. If Yahoo returns error, then returned value is undef.

In list context this function returns list from three elements where first one is a result as in scalar context, the second one is a HTTP::Response from LWP::UserAgent and third one is a perl hash with response data from Yahoo. This can be usefull for debugging purposes, for querying failure details and for detailed info from yahoo.

BUGS ^

If you find any, please report ;)

AUTHOR ^

Ivan Baktsheev <dot.and.thing@gmail.com>.

COPYRIGHT ^

Copyright 2008, Ivan Baktsheev

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

syntax highlighting: