Skip to content
This repository has been archived by the owner on Feb 2, 2023. It is now read-only.


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


If you want it, fork it. Just don't ask me to fix it.

Twitter API WordPress Library

This library exposes a fully authenticated Twitter API client for developing WordPress plugins.


  • Compatible with the new Twitter API 1.1
  • OAuth flow connects your Twitter account via WordPress admin
  • Access to a common Twitter API client that any plugin can use
  • Caching of API responses
  • Light-weight: uses WordPress utilities where possible

Example plugin

See the Latest Tweets Widget for an example plugin using this library.


Clone this repo to where you will develop your plugin. e.g.

git submodule add \

To expose the library and its admin functions, bootstrap the library from your own plugin as follows:

 * Plugin Name: My Twitter Plugin
if( ! function_exists('twitter_api_get') ){
    require dirname(__FILE__).'/api/twitter-api.php';


Once the plugin is installed and enabled, you can bind it to a Twitter account as follows:

  • Register a Twitter application at
  • Note the Consumer key and Consumer secret under OAuth settings
  • Log into WordPress admin and go to Settings > Twitter API
  • Enter the consumer key and secret and click 'Save settings'
  • Click the 'Connect to Twitter' button and follow the prompts.

Any WordPress plugin can now make fully authenticated calls to the Twitter API. The functions are documented below.

Twitter Client

To check whether the user has authenticated the plugin and configured the oAuth tokens you can use the following function.


bool twitter_api_configured () Returns True if the user has authenticated the plugin and configured oAuth tokens

The following functions are available from anywhere as soon as the plugin is authenticated. They all operate as the Twitter account you connected in your admin area.


array twitter_api_get ( string $path [, array $args ] )
GETs data from the Twitter API, returning the raw unserialized data.

$path is any Twitter API method, e.g. 'users/show' or 'statuses/user_timeline'
$args is an associative array of parameters, e.g. array('screen_name'=>'timwhitlock')

Note that neither the path nor the arguments are validated.


array twitter_api_post ( string $path [, array $args ] )
As above, but POSTs data to the Twitter API.


TwitterApiClient twitter_api_enable_cache( int $ttl )
Enable caching of Twitter response data for $ttl seconds.


TwitterApiClient twitter_api_disable_cache( )
Disables caching of responses. Caching is disabled by default.

Custom OAuth flows

The above functions work with a single authenticated Twitter account. If you want to authenticate multiple clients or create OAuth flows other than the one provided, you'll have to work directly with the TwitterApiClient class and roll your own OAuth user flows.

The following utility functions will do some lifting for you, but please see Twitter's own documentation if you're not familiar with the process.


TwitterOAuthToken twitter_api_oauth_request_token ( string $consumer_key, string $consumer_secret, string $oauth_callback )
Fetches an OAuth request token from Twitter: e.g. { key: 'your request key', secret: 'your request secret' }


TwitterOAuthToken twitter_api_oauth_access_token ( $consumer_key, $consumer_secret, $request_key, $request_secret, $oauth_verifier ) Exhanges a verified request token for an access token: e.g. { key: 'your access key', secret: 'your access secret' }


Once you have your own authentication credentials you can work directly with the API client. This example shows the main methods you might use:

    try {
        if ( twitter_api_configured() ) {
            $Client = twitter_api_client('some client');
            $Client->set_oauth( 'my consumer key', 'my consumer secret', 'their access key', 'their access secret' );
            $user = $Client->call( 'users/show', array( 'screen_name' => 'timwhitlock' ), 'GET' );
            var_dump( $user );
    catch( TwitterApiRateLimitException $Ex ){
        $info = $Client->last_rate_limit();
        wp_die( 'Rate limit exceeded. Try again at '.date( 'H:i:s', $info['reset'] ) );
    catch( TwitterApiException $Ex ){
        wp_die( 'Twitter responded with status '.$Ex->getStatus().', '.$Ex->getMessage() );
    catch( Exception $Ex ){
        wp_die( 'Fatal error, '. $Ex->getMessage() );


[ABANDONED] Wordpress utility providing authenticated access to the Twitter API for use in your own plugins






No releases published


No packages published