Core API

The Core API provides data about URLs TweetMeme has collected from Twitter.

Methods

URL Info

Takes any URL posted to Twitter and resolves it to its original URL as well as details about that webpage, such as the title.

URL: http://api.tweetmeme.com/url_info.format

Formats: xml, json, php

Parameters:

• url: string the URL of the webpage to resolve

Returns: Info about the URL

• title: string the title of the page
• url: string the final URL of the page
• media_type: string the media type of the content (news/image/video)
• created_at: datetime the date and time of the first tweet posted containing this URL
• url_count: int the number of times this link has been tweeted
• comment_count: int the number of comments the story has on TweetMeme
• excerpt: string a string of text about the story, taken either from a tweet with the URL or from the page content itself
• (optional) thumbnail: string the URL of a thumbnail image relating to the story (taken from the page itself – may not appear if TweetMeme has not acquired an image for this URL)

Example Requests:

• http://api.tweetmeme.com/url_info?url=http://is.gd/lznv
• http://api.tweetmeme.com/url_info?url=http://www.tweetmeme.com

Example Output (in XML)

<?xml version="1.0" encoding="UTF-8"?>
<result>
	<status>success</status>
	<story>
		<title>New Google Logo Celebrates The Barcode</title>
		<url> http://www.techcrunch.com/2009/10/06/new-google-logo-celebrates-the-barcode/ </url>
		<media_type>news</media_type>
		<created_at>2009-10-07T05:44:02+00:00</created_at>
		<url_count>434</url_count>
		<comment_count>0</comment_count>
		<excerpt>
			Google&#8217;s new logo is a barcode which, as far as we can tell, says &#8220;Google.&#8221; Today is the 57th anniversary of the first patent on the bar code. Inventors Norman Woodland and Bernard Silver filed the patent on October 1949, and it was granted, No. 2,612,994 (pdf), on October 7, 1952. The original patent was for a system that would encode data in circles (a bulls eye pattern), so...
		</excerpt>
		<thumbnail>http://tweetmeme.s3.amazonaws.com/thumbs/207093919.jpg</thumbnail>
	</story>
</result>