- Awesome Twitter Search Badges

Step 1: Search options

Set your search terms, title your badge, and set how many results you want to show.

Step 2: Look and feel

Style your badge by changing the colors of the boxes below. Click in a box to change the color, and watch your badge update on the right. Mix and match to your hearts content!

Generate Badge Code

Step 3: Use your Badge

We've generated some code below that will automatically add your badge to your page or blog. To use it, simple copy all of it, and paste it wherever you use HTML.



Who are you guys?

Ryan McGrath and Brandon Leonardo.

What was the inspiration for this?

We believe that Twitter's doing something awesome these days. It's easily one of the biggest hubs of activity on the internet, and with that comes a wealth of information that's available in real time. As important as Twitter is as a "Communications Platform", Twitter's purpose as a Search Engine is rapidly becoming one of the most useful and valuable parts of Twitter.

After searching for something similar to a Twitter Search badge to easily leverage that search engine, and failing to find anything, Brandon decided to build one himself. While Twitter does provide badges and widgets, the current badges and widgets merely display YOUR latest tweets. We wanted one that would showcase search results from Twitter's stream, and we wanted it to be completely plug and play.

Both Brandon and Ryan have experience with the Twitter API (Brandon built StopTweet, and Ryan has a Python Library (Twython) that wraps Twitter's API). The combined experience paved the way to a system where the Search keywords and design system are customizable. Now, you can customize your badge to match the look and feel of your website or blog. We offer these badges completely free of charge. Have a blast!

Contact Information

Questions, comments? You can hit both Ryan McGrath and Brandon Leonardo on Twitter, or follow on Twitter!

X Questions

What exactly is this widget?

This site generates a simple bit of HTML code that you can insert on your website, company site, or social network profile to instantly display Twitter Search results for the specified keywords. It's highly customizable and should be able to fit right in on any page.

Why would I want to use this?

To easily display real-time search results on your website, of course. Some initial uses we've thought of include:

  1. Company - Stick your company name with a smiley face in the keywords ( i.e. ' :)' ) and put this badge on your company's home page.
  2. Blogger - Put your badge at the end of a post, with keywords relating to the topic. Your readers can get a snapshot of what Twitter thinks about it.
  3. Person/Celebrity - Stick this on your webpage, or social network profile with your name specified as the keyword.

The possibilities are endless, and we haven't figured out every way people will use this, so be creative.

Are there more levels of customization?

Beyond the initial level of customization that we offer, you can further customize with CSS. Click here to get an example CSS template.


TwitStatus Terms and Conditions of Use

1. Terms

By accessing this web site, you are agreeing to be bound by these web site Terms and Conditions of Use, all applicable laws and regulations, and agree that you are responsible for compliance with any applicable local laws. If you do not agree with any of these terms, you are prohibited from using or accessing this site. The materials contained in this web site are protected by applicable copyright and trade mark law.

2. Use License

  1. TwitStatus badges can be used in any purpose, anywhere. We only ask that you don't remove the link back to us. TwitStatus can not be copied and/or sold for any purposes; it is and should always remain free and open source.
  2. This license shall automatically terminate if you violate any of these restrictions and may be terminated by at any time. Upon terminating your viewing of these materials or upon the termination of this license, you must destroy any downloaded materials in your possession whether in electronic or printed format.

3. Disclaimer

  1. The materials on's web site are provided "as is". makes no warranties, expressed or implied, and hereby disclaims and negates all other warranties, including without limitation, implied warranties or conditions of merchantability, fitness for a particular purpose, or non-infringement of intellectual property or other violation of rights. Further, does not warrant or make any representations concerning the accuracy, likely results, or reliability of the use of the materials on its Internet web site or otherwise relating to such materials or on any sites linked to this site.

4. Limitations

In no event shall or its suppliers be liable for any damages (including, without limitation, damages for loss of data or profit, or due to business interruption,) arising out of the use or inability to use the materials on's Internet site, even if or a authorized representative has been notified orally or in writing of the possibility of such damage. Because some jurisdictions do not allow limitations on implied warranties, or limitations of liability for consequential or incidental damages, these limitations may not apply to you.

5. Revisions and Errata

The materials appearing on's web site could include technical, typographical, or photographic errors. does not warrant that any of the materials on its web site are accurate, complete, or current. may make changes to the materials contained on its web site at any time without notice. does not, however, make any commitment to update the materials.

6. Links has not reviewed all of the sites linked to its Internet web site and is not responsible for the contents of any such linked site. The inclusion of any link does not imply endorsement by of the site. Use of any such linked web site is at the user's own risk.

7. Site Terms of Use Modifications may revise these terms of use for its web site at any time without notice. By using this web site you are agreeing to be bound by the then current version of these Terms and Conditions of Use.

8. Governing Law

Any claim relating to's web site shall be governed by the laws of the State of California without regard to its conflict of law provisions.

We are committed to conducting our business in accordance with these principles in order to ensure that the confidentiality of personal information is protected and maintained.