README
1NAME
2 WebService::Technorati - a Perl interface to the Technorati web services
3 interface
4
5SYNOPSIS
6 use WebService::Technorati;
7
8 my $apiKey = 'myverylongstringofcharacters';
9 my $url = 'http://www.arachna.com/roller/page/spidaman';
10 my $t = WebService::Technorati->new(key => $apiKey);
11 my $q = $t->getCosmosApiQuery($url);
12 $q->execute;
13
14 my $linkedUrl = $q->getLinkQuerySubject();
15 # do something with the linkedUrl
16
17 my $links = $q->getInboundLinks();
18 for my $link (@$links) {
19 # do something with the link
20 }
21
22DESCRIPTION
23 The Technorati web services interfaces use REST wire protocol with a
24 format described at http://developers.technorati.com/
25
26USAGE
27 Please see the test files in t/ and samples in eg/ for examples on how
28 to use WebServices::Technorati
29
30BUGS
31 No bugs currently open
32
33SUPPORT
34 Join the Technorati developers mailing list at
35 http://mail.technorati.com/mailman/listinfo/developers
36
37AUTHOR
38 Ian Kallen
39 ikallen _at_ technorati.com
40 http://developers.technorati.com
41
42COPYRIGHT
43 This program is free software; you can redistribute it and/or modify it
44 under the terms of the following Creative Commons License:
45 http://creativecommons.org/licenses/by/2.0 as well as the
46 indemnification provisions of the Apache 2.0 style license, the full
47 text of which can be found in the LICENSE file included with this
48 module.
49
50CREDITS
51
52 David Sifry defined the Technorati web services REST interface
53 Erik Benson wrote the original Perl implementation
54
55SEE ALSO
56 perl(1).
57
58 getCosmosApiQuery
59 Usage : getCosmosApiQuery('http://www.example.com')
60 Purpose : Instantiates a CosmosApiQuery with the given url
61 Returns : WebService::Technorati::CosmosApiQuery
62 Argument : a url
63 Throws : WebService::Technorati::InstantiationException when called
64 : without an api key
65 Comments : WebService::Technorati::CosmosApiQuery is a Perl interface to the Technorati
66 : web services 'cosmos' interface
67
68 See Also : WebService::Technorati::CosmosApiQuery
69
70 getSearchApiQuery
71 Usage : getSearchApiQuery('keyword')
72 Purpose : Instantiates a SearchApiQuery with the given keyword
73 Returns : a WebService::Technorati::SearchApiQuery that may be executed
74 Argument : a keyword search term
75 Throws : WebService::Technorati::InstantiationException when called
76 : without an api key
77 Comments : WebService::Technorati::SearchApiQuery is a Perl interface to the Technorati
78 : web services 'search' interface
79
80 See Also : WebService::Technorati::SearchApiQuery
81
82 getOutboundApiQuery
83 Usage : getOutboundApiQuery('http://www.example.com')
84 Purpose : Instantiates a OutboundApiQuery with the given url
85 Returns : WebService::Technorati::OutboundApiQuery
86 Argument : a url
87 Throws : WebService::Technorati::InstantiationException when called
88 : without an api key
89 Comments : WebService::Technorati::OutboundApiQuery is a Perl interface to the Technorati
90 : web services 'outbound' interface
91
92 See Also : WebService::Technorati::OutboundApiQuery
93
94 getAuthorinfoApiQuery
95 Usage : getAuthorinfoApiQuery('username')
96 Purpose : Instantiates a AuthorinfoApiQuery with the given username
97 Returns : WebService::Technorati::AuthorinfoApiQuery
98 Argument : a url
99 Throws : WebService::Technorati::InstantiationException when called
100 : without an api key
101 Comments : WebService::Technorati::AuthorinfoApiQuery is a Perl interface to the Technorati
102 : web services 'getinfo' interface
103
104 See Also : WebService::Technorati::AuthorinfoApiQuery
105
106 getBloginfoApiQuery
107 Usage : getBloginfoApiQuery('http://www.example.com')
108 Purpose : Instantiates a BloginfoApiQuery with the given url
109 Returns : WebService::Technorati::BloginfoApiQuery
110 Argument : a url
111 Throws : WebService::Technorati::InstantiationException when called
112 : without an api key
113 Comments : WebService::Technorati::BloginfoApiQuery is a Perl interface to the Technorati
114 : web services 'bloginfo' interface
115
116 See Also : WebService::Technorati::BloginfoApiQuery
117
118STANDARD INSTALL
119
120perl Makefile.PL
121make
122make test
123make install
124
125
126If you are on a windows box you should use 'nmake' rather than 'make'.
127
128