Developer Center

Tag Query

The tag query allows you to get a list of posts with the given tag associated with it. On the Technorati site, the tag pages show posts with the tag associated as well as content from external folksonomies. The API version allows you to use the tagged posts in your own application.

The call is made using a REST-ful interface. Send either a HTTP GET or a HTTP POST to http://api.technorati.com/tag?key=[apikey]&tag=[tag] with mandatory parameters "key" and "tag" and additional optional parameters described below.

Parameters

Mandatory

key: Your Technorati API key, which you can obtain on our API key page.
tag: Set this to the tag term you are searching posts for.

Optional

format: This allows you to request an output format, which by default is set to xml. At the moment only the XML (xml) and RSS (rss) formats are supported. We plan to support the Atom Syndication Format as well as XOXO in the near future.
limit: Set this to a number larger than 0 and smaller or equal to 100 and it will return limit number of posts for a tag. By default this value is 20.
start: Set this to a number larger than 0 and you'll get the start+limit freshest posts, e.g. set it to limit+1, and you'll get the second page of rankings.
excerptsize: Number of word characters to include in the post excerpts. By default 100 word characters are returned.
topexcerptsize: Number of word characters to include in the first post excerpt. By default 150 word characters are returned.

Response

Success

<?xml version="1.0" encoding="utf-8"?>
<!-- generator="Technorati API version 1.0 /tag" -->
<!DOCTYPE tapi PUBLIC "-//Technorati, Inc.//DTD TAPI 0.02//EN" "http://api.technorati.com/dtd/tapi-002.xml">
<tapi version="1.0">
<document>
<result>
  <query>[tag]</query>
  <postsmatched>[number of posts that match the tag]</postsmatched>
  <blogsmatched>[number of blogs that match the tag]</blogsmatched>
  <start>[value of the start parameter]</start>
  <limit>[value of limit parameter]</limit>
  <querytime>[duration of query]</querytime>
</result>
<item>
  <weblog>
    <name>[name of blog containing match]</name>
    <url>[blog URL]</url>
    <rssurl>[blog RSS URL]</rssurl>
    <atomurl>[blog Atom URL]</atomurl>
    <inboundblogs>[inbound blogs]</inboundblogs>
    <inboundlinks>[inbound links]</inboundlinks>
    <lastupdate>[date blog last updated]</lastupdate>
  </weblog>
  <title>[entry title]</title>
  <excerpt>[entry blurb with term highlighting]</excerpt>
  <created>[date entry created]</created>
  <postupdate>[date post last updated]</postupdate>
  <permalink>[blog entry URL]</permalink>
</item>
</document>
</tapi>