jtwt.js is an easy-to-use jQuery plugin that allows you to display your recent tweets on your website or elsewhere.
JavaScript CSS
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



This project is not maintened anymore. Since Twitter API Ver. 1.1 all relevant endpoints are protected and are requiring authentication through the user. Authorization-free fetching of public data such as tweets is therefore not possible anymore, which makes jquery.jtwt's original purpose obsolete.

jtwt.js - a simple jQuery plugin for the twitter Search API

jtwt.js is an easy-to-use jQuery plugin that allows you to display your recent tweets on your website or elsewhere.


At first you will need to implement the jQuery library in the <head> area of your document, like this:

<script type="text/javascript" src="js/jquery.js"></script>

Add the jtwt.js and the jtwt.css below the jQuery library:

<script type="text/javascript" src="js/jtwt.min.js"></script>
<link rel="stylesheet" href="css/jtwt.css" />

Now initialize the jtwt plugin between a $(window).load(function() { and a });.

<script type="text/javascript">
  $(window).load(function() {
			username : 'yourusername'

At last, we need to create the already declared container for our twitter widget:

<div id="twitter"></div>


jtwt.js comes with a bunch of options to create the best experience for your users.

	count : int, // The number of displayed tweets.
	username : 'yourusername', // Your username.
	query : 'searchquery', // Performs a search query.
	convert_links : boolean, //Converts hashtags to links
	image_size : int, // The size of your avatar.
	loader_text : 'loading tweets', // loading text
	no_result : 'No tweets found' // no results text

Since jtwt.js makes use of Twitter's Search API, you can also perform search queries instead of displaying a users recent tweets.

To make use of this function, just assign the query option with suitable search query. There is no need for a username, you just need a query. If there is any username assigned, jtwt will just overwrite it with the given query.

	query : '#batman', //Tweets with the hashtag #batman

jtwt can perform any search query that is valid to the syntax of Twitter's search function. For more information please visit: https://dev.twitter.com/docs/using-search


  • 10/26/2012 - Added retweet support + Bug fix
  • 1/15/2013 - Bug Fix + new time ago function (thanks to @mikloshenrich)
  • 4/5/2013 - Changed to Twitter's search API + search query function


jtwt.js is contributed under the Creative Commons Attribution 3.0 Unported license. You're free to use jtwt.js in personal and commercial projects.


jtwt.js is provided "as-is", without any warranty and professional support. However, we're happy to help if we can. Feel to drop us a line. It may take up to 48 hours till you receive an answer.