Outbound Query
Info
The outbound query lets you see what blogs are linked to on a given blog, including their associated info.Format
The call is made using a REST-ful interface. Send either a HTTP GET or a HTTP POST to http://api.technorati.com/outbound?key=<apikey>&url=<url> with mandatory parameters "key" and "url" and additional optional parameters described below.
Parameters
-
key (mandatory) - Provide your Technorati API key in here, which you can obtain at
![[WWW]](https://cdn.statically.io/img/web.archive.org/web/20051228095957im_/http://developers.technorati.com/content/rightsidebar/img/moin-www.png)
http://www.technorati.com/developers/apikey.html.
-
url (mandatory) - Set this to the target URL you are searching for. The 'http://' prefix is optional.
-
format - This allows you to request an output format, which by default is set to xml. At the moment only the XML and RSS formats are supported. Atom and XOXO should be supported soon.
-
start - Set this to a number larger than 0 and you'll get the <start>+20 freshest links to blogs, e.g. set it to 20+1, and you'll get the second page of rankings 21-40.
Response
The outbound query either returns a list of links and associated info or an error message. Error responses are always in default XML format and look like this:
<?xml version="1.0" encoding="utf-8"?> <!-- generator="Technorati API version 1.0 /outbound" --> <!DOCTYPE tapi PUBLIC "-//Technorati, Inc.//DTD TAPI 0.02//EN" "http://api.technorati.com/dtd/tapi-002.xml"> <tapi version="1.0"> <document> <result> <error>ERROR MESSAGE</error> </result> </document> </tapi>
On success, for the default format, the response is as follows:
<?xml version="1.0" encoding="utf-8"?>
<!-- generator="Technorati API version 1.0 /outbound" -->
<!DOCTYPE tapi PUBLIC "-//Technorati, Inc.//DTD TAPI 0.02//EN" "http://api.technorati.com/dtd/tapi-002.xml">
<tapi version="1.0">
<document>
<result>
<url>BLOG URL</url>
<weblog>
<name>SOURCE BLOG NAME</name>
<url>SOURCE BLOG URL</url>
<rssurl>SOURCE BLOG RSS URL</rssurl>
<atomurl>SOURCE BLOG ATOM URL</atomurl>
<inboundblogs>INBOUND BLOGS</inboundblogs>
<inboundlinks>INBOUND LINKS</inboundlinks>
<lastupdate>DATE BLOG WAS LAST UPDATED</lastupdate>
<rank>COSMOS RANKING</rank>
</weblog>
<inboundblogs>INBOUND BLOGS</inboundblogs>
<inboundlinks>INBOUND LINKS</inboundlinks>
<rankingstart>START PARAMETER VALUE</rankingstart>
</result>
<item>
<weblog>
<name>LINKED BLOG NAME</name>
<url>LINKED BLOG URL</url>
<rssurl>LINKED BLOG RSS URL</rssurl>
<atomurl>LINKED BLOG ATOM URL</atomurl>
<inboundblogs>INBOUND BLOGS</inboundblogs>
<inboundlinks>INBOUND LINKS</inboundlinks>
<lastupdate>DATE BLOG WAS LAST UPDATED</lastupdate>
</weblog>
</item>
...
</document>
</tapi>
The date is set to standard format as in: 2004-02-04 06:28:26 GMT.