Skip to content
Fetches your latest tweets from your website, no server scripts needed
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Fetches your latest tweets

twitterFetch shows your latest tweets on your website.

⚠️ Warning: Twitter switched to iframes to embed Twitter widgets and disabled fetching the feed from JavaScript. This means twitterFetch is no longer working! This repository is only for informational purposes. ⚠️

Twitter already offers two options to show your tweets on your website:

  1. Using a Twitter widget
  2. Using the Twitter REST API

They are fully supported by Twitter and might be the best solution for you.

Disadvantages are:

  1. Limited layout possibilities (widget).
  2. Cookies are send to Twitter, which, without warning, might be illegal in your jurisdiction (widget).
  3. Page load (widget).
  4. Needs server side scripting (api).

TwitterFetch provides a solution without these disadvantages. It fetches the Twitter widget (without sending cookies) and makes the tweets available in JavaScript, to be placed on a webpage the way you want. Less than 2kB, twitterFetch is also very lightweight.

TwitterFetch uses unsupported Twitter functionality, so there's no guarantee of continuity.


Start by downloading twitterfetch.js to you server and including it in your web page.

<script src="twitterfetch.js">

In your HTML, make sure you have a place to show the tweets:

<div id="tweets"></div>

Now, use twitterFetch to fetch the tweets and show the first one:

twitterFetch.fetch('345615146724495360', {}, function (tweets) {
	if (!tweets || tweets.length == 0) {
	document.getElementById('tweets').innerHTML = tweets[0];

But don't use the widget id 345615146724495360, that belongs to my @edwinmdev Twitter account.

How to make your own widget id?

Create a Twitter widget and look at the generated code. You'll find data-widget-id="..." with the number you can use.


The twitterFetch fetch function takes three parameters:

twitterFetch.fetch(widgetId, options, callbackFunction);


The widget id you get when creating a widget, see above.


An object literal with several options:

images (boolean): when false, prevents loading images that are not needed (default: false).

plaintext (boolean): when false, encodes some entities to make the text safe for HTML (default: false).

hyperlinks (boolean): when true, turns urls and Twitter @usernames into hyperlinks (default: true).


	images: false,
	plaintext: true


The function that is called back with one argument containing an array with tweets.


TwitterFetch is copyright 2016 Edwin Martin and MIT licensed.

You can’t perform that action at this time.