Twitter Search API Using PHP and Guzzle

In case you missed it, Twitter updated their APIs recently, so that you have to authenticate to use even their search APIs to return publicly-available results. This is an increasing trend for API providers, to provide either very limited or nonexistent access for unauthenticated users, I think so they can rate limit consumers that swamp them. To cut a long story short, that meant I needed to update my dashboards that keep an eye on twitter searches to do more than just call file_get_contents in the general direction of the right URL.

I picked Guzzle to achieve this, mostly out of curiosity. I tend to favour extensions over userland code because they perform better, but I had it on good authority that Guzzle actually understands HTTP correctly (surprisingly unusual in PHP implementations of “HTTP” or “REST” tools!), and for a low-traffic personal dashboard, performance isn’t an issue. Guzzle is a modern library with Composer support and a tidy, modern interface, and I enjoyed using it, so I thought I’d share how my twitter search consuming code looks.

Searching Twitter with Guzzle

These examples contain references to a variable called $twitter – this contains twitter-related settings and lives in a separate config file to make it harder for me to share my API keys inappropriately :)

First, we create the Guzzle client to talk to twitter. This has a lovely trick for using URL templates and replacing bits of that with variables, so I’ve used it when I first connect. Twitter’s API is currently at v1.1, but this may change, so my code looks like this:

$twitter_client = new \Guzzle\Http\Client('{version}', array(
        'version' => '1.1'

Next, we need to attach our authentication details to the request. Twitter uses OAuth which is very convenient, and Guzzle supports this, so we just need to add our details to the client we created, which looks like this:

$twitter_client->addSubscriber(new Guzzle\Plugin\Oauth\OauthPlugin(array(
    'consumer_key'  => $twitter['consumer_key'],
    'consumer_secret' => $twitter['consumer_secret'],
    'token'       => $twitter['access_token'],
    'token_secret'  => $twitter['access_token_secret']

The settings for your twitter security credentials can be obtained by registering for an API key at You can then generate an access token and secret from the same page, which is very handy, and use them here.

At this point, we can make any twitter API calls we’d like to; this example goes on to make search queries, but there’s a raft of documentation for anything else you might like to do with twitter and Guzzle.

The search terms themselves can contain AND and OR operators, and you can also pass a selection of other parameters to customise the results for language, recentness, and who knows what else – again, excellent documentation is available. This example is just a basic search, which I achieve with the following:

$request = $twitter_client->get('search/tweets.json');
$request->getQuery()->set('q', $search);
$response = $request->send();

Twitter speaks JSON, so we will want to json_decode() the body of the response:

$tweets = json_decode($response->getBody());

This gives an array of tweets, and you can inspect the fields to find what you need, I mostly use the following:

  • text: the body of the tweet
  • id_str: the identifier of the tweet
  • user[‘screen_name’]: the user whose tweet this is

Hopefully that gives you an easy example to start using Guzzle for this, and many other, applications.

9 thoughts on “Twitter Search API Using PHP and Guzzle

  1. Pingback: Using Composer in an Existing Project | LornaJane

  2. Pingback: Twitter Search API Using PHP and Guzzle | Advan...

  3. This is a lovely tutorial, but it describes the syntax of Guzzle version 3. Version 4 is out and has a much changed syntax for this kind of thing.

    Thanks for the tutorial and for turning me on to Guzzle.


    • Thanks for mentioning this! I don’t remove old posts but it’s really helpful when people post to say which versions something does or does not work with – thank you for taking the time to comment on this one.

Leave a Reply

Please use [code] and [/code] around any source code you wish to share.

This site uses Akismet to reduce spam. Learn how your comment data is processed.