(Perl) 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 Perl Downloads Perl Module for Windows, MacOS, Linux, Alpine Linux, Solaris

use chilkat();

# 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 = chilkat::CkJsonObject->new();
$success = $json->LoadFile("qa_data/tokens/twitter.json");

$rest = chilkat::CkRest->new();
$oauth1 = chilkat::CkOAuth1->new();

$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,0);

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

# This ends the initial setup...
# ----------------------------------------------------------------------

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

$jsonResponse = chilkat::CkJsonObject->new();
$jsonResponse->put_EmitCompact(0);

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

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

    if ($sbNextCursor->ContentsEqual("0",$caseSensitive) == 1) {
        # This will cause the loop to exit..
        $bContinue = 0;
    }
    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() != 1) {
            print $rest->lastErrorText() . "\r\n";
            exit;
        }

        $jsonResponse->Load($resp);

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

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

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

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

        }

        $pageNum = $pageNum + 1;
        if ($pageNum > 5) {
            $bContinue = 0;
        }
        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
#