(PHP Extension) Twitter - Get Follower IDs

Demonstrates how to get a list of follower IDs for a Twitter user. If the number of followers is more than can be returned in a single response, this example will use cursors to page through the followers.

Note: Rate limits will prevent a program from paging through huge lists of followers. In general, a maximum of 16 GET requests (pages) can be retrieved in a short period of time.

Chilkat PHP Downloads PHP Extension for Windows, Linux, MacOS, Alpine Linux, Solaris

<?php

// The version number (9_5_0) should match version of the Chilkat extension used, omitting the micro-version number.
// For example, if using Chilkat v9.5.0.48, then include as shown here:
include("chilkat_9_5_0.php");

// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

// ----------------------------------------------------------------------
// This initial setup, which involves setting the OAuth1 properties and connecting
// to api.twitter.com, is only required once at the beginning.  Once connected, the same
// object instance may be re-used, and if necessary, it will automatically reconnect
// as needed.

// Assume we've previously obtained an access token and saved it to a JSON file..
$json = new CkJsonObject();
$success = $json->LoadFile('qa_data/tokens/twitter.json');

$rest = new CkRest();
$oauth1 = new CkOAuth1();

$oauth1->put_ConsumerKey('TWITTER_CONSUMER_KEY');
$oauth1->put_ConsumerSecret('TWITTER_CONSUMER_SECRET');
$oauth1->put_Token($json->stringOf('oauth_token'));
$oauth1->put_TokenSecret($json->stringOf('oauth_token_secret'));
$oauth1->put_SignatureMethod('HMAC-SHA1');
$oauth1->GenNonce(16);

$rest->SetAuthOAuth1($oauth1,false);

$bAutoReconnect = true;
$success = $rest->Connect('api.twitter.com',443,true,$bAutoReconnect);
if ($success != true) {
    print $rest->lastErrorText() . "\n";
    exit;
}

// This ends the initial setup...
// ----------------------------------------------------------------------

// This Twitter user has about 77.5K followers..
$rest->AddQueryParam('screen_name','MarcusMiller959');

$jsonResponse = new CkJsonObject();
$jsonResponse->put_EmitCompact(false);

// Get the 1st page of results using a cursor of "-1".
$sbNextCursor = new CkStringBuilder();
$sbNextCursor->SetString('-1');

$pageNum = 1;
$caseSensitive = false;
$bContinue = true;
// Get a maximum of 5 pages (of 5000 ids each).
while ($bContinue == true) {

    if ($sbNextCursor->ContentsEqual('0',$caseSensitive) == true) {
        // This will cause the loop to exit..
        $bContinue = false;
    }
    else {
        // Adds or replaces the query param.
        $rest->AddQueryParam('cursor',$sbNextCursor->getAsString());

        // Get the next page of follower IDs
        $resp = $rest->fullRequestNoBody('GET','/1.1/followers/ids.json');
        if ($rest->get_LastMethodSuccess() != true) {
            print $rest->lastErrorText() . "\n";
            exit;
        }

        $jsonResponse->Load($resp);

        if ($rest->get_ResponseStatusCode() != 200) {
            print $jsonResponse->emit() . "\n";
            exit;
        }

        // Show the number of IDs returned in this 
        $numIds = $jsonResponse->SizeOfArray('ids');
        print 'Page ' . $pageNum . ', Number of Ids: ' . $numIds . "\n";

        // Show the 1st 10 ids in this page.
        $i = 0;
        while ($i < $numIds) {
            $jsonResponse->put_I($i);
            print '    ' . $i . ': ' . $jsonResponse->stringOf('ids[i]') . "\n";

            $i = $i + 1;
            if ($i > 10) {
                // Force the loop to exit.
                $i = $numIds;
            }

        }

        $pageNum = $pageNum + 1;
        if ($pageNum > 5) {
            $bContinue = false;
        }
        else {
            $sbNextCursor->SetString($jsonResponse->stringOf('next_cursor_str'));
        }

    }

}

// A successful JSON response for the 1st page looks like this:

// 	{
// 	  "ids": [
// 	    3140496044,
// 	    793204773751324672,
// 	    789951187781050369,
// 	    763520773587922945,
// 	    ...
// 	    15031286,
// 	    2668251246,
// 	    3751659443
// 	  ],
// 	  "next_cursor": 1531680438812851153,
// 	  "next_cursor_str": "1531680438812851153",
// 	  "previous_cursor": 0,
// 	  "previous_cursor_str": "0"
// 	}

// The output of this program looks like this:

// 	Page 1, Number of Ids: 5000
// 	    0: 931953350
// 	    1: 786708055
// 	    2: 560845700
// 	    3: 3140496044
// 	    4: 793204773751324672
// 	    5: 789951187781050369
// 	    6: 763520773587922945
// 	    7: 793143274059988992
// 	    8: 793139683412762624
// 	    9: 1588222783
// 	    10: 703821370778451968
// 	Page 2, Number of Ids: 5000
// 	    0: 15031286
// 	    1: 2668251246
// 	    2: 3751659443
// 	    3: 3324584493
// 	    4: 2440214809
// 	    5: 1322335441
// 	    6: 4439178393
// 	    7: 4911573711
// 	    8: 720792880080560128
// 	    9: 720805087124267008
// 	    10: 172926330
// 	Page 3, Number of Ids: 5000
// 	    0: 93867176
// 	    1: 2992946183
// 	    2: 2825296077
// 	    3: 3784572861
// 	    4: 2150051321
// 	    5: 2460881603
// 	    6: 4128849341
// 	    7: 2234697931
// 	    8: 2379418164
// 	    9: 3425171542
// 	    10: 325759186
// 	Page 4, Number of Ids: 5000
// 	    0: 22793412
// 	    1: 3347750489
// 	    2: 316923043
// 	    3: 2481719196
// 	    4: 3363591905
// 	    5: 3238116492
// 	    6: 58467130
// 	    7: 3015182362
// 	    8: 2985342719
// 	    9: 3095965720
// 	    10: 17505957
// 	Page 5, Number of Ids: 5000
// 	    0: 2541434684
// 	    1: 140022957
// 	    2: 134845054
// 	    3: 772810508
// 	    4: 16979294
// 	    5: 2320540225
// 	    6: 105439442
// 	    7: 2796744529
// 	    8: 251128801
// 	    9: 350229758
// 	    10: 2683994716
// 

?>