Deprecation Notice: pagination on several methods is being replaced with cursoring on October 26, 2009

35 views
Skip to first unread message

Alex Payne

unread,
Sep 24, 2009, 8:47:35 PM9/24/09
to Twitter Development Talk, twitter-ap...@googlegroups.com
Hi,

Recently, we documented a new pagination mechanism for our "social
graph" methods, /friends/ids and /followers/ids. Traditional
page-based pagination doesn't dovetail with our recent backend
changes, and we've now exposed a cursor-based pagination mechanism
that's far more reliable.

Today, we've documented that this new pagination mechanism is also
available for the /statuses/friends and /statuses/followers methods.
With that change, we're setting a hard deprecation date for
traditional pagination on these four methods: October 26th, 2009.
That's over a month from now.

Once deprecated, we'll simply ignore the "page" parameter if it's sent
by a client, and you'll get the default number of items for the method
you're calling.

For more information, see
http://apiwiki.twitter.com/Twitter-API-Documentation. Thanks.

--
Alex Payne - Platform Lead, Twitter, Inc.
http://twitter.com/al3x

Dewald Pretorius

unread,
Sep 24, 2009, 10:07:12 PM9/24/09
to Twitter Development Talk
Alex,

Thanks for this.

Is there any way that response times on the call could be improved?

It takes around 4 seconds to retrieve one cursor. When one retrieves
the followers/friends of an account with 100,000 of those, with 100
followers/friends per cursor, it takes more than an hour to retrieve
all the followers/friends.

It's not a train smash issue, it would just be good to have faster
response times. I have noticed the same slower response times
(measured against 0.4 seconds for other calls) on the social graph
methods when using cursors.

Dewald

Alex Payne

unread,
Sep 25, 2009, 12:58:43 PM9/25/09
to twitter-deve...@googlegroups.com
I'll pass those numbers along to our App Services team and see what they can do.

--

Kyle Mulka

unread,
Oct 8, 2009, 6:26:54 AM10/8/09
to Twitter Development Talk
Will the page parameter on /statuses/user_timeline (or on any of the
other timeline methods) be deprecated as well?
https://twitterapi.pbworks.com/Twitter-REST-API-Method%3A-statuses-user_timeline

I've noticed a lot of failures on /statuses/user_timeline recently.
Instead of the page parameter, is it better to use max_id?

--
Kyle Mulka
http://twilk.com - put your friends faces on your Twitter background

On Sep 24, 8:47 pm, Alex Payne <a...@twitter.com> wrote:
> Hi,
>
> Recently, we documented a new pagination mechanism for our "social
> graph" methods, /friends/ids and /followers/ids. Traditional
> page-based pagination doesn't dovetail with our recent backend
> changes, and we've now exposed acursor-based pagination mechanism
> that's far more reliable.
>
> Today, we've documented that this new pagination mechanism is also
> available for the /statuses/friends and /statuses/followers methods.
> With that change, we're setting a hard deprecation date for
> traditional pagination on these four methods: October 26th, 2009.
> That's over a month from now.
>
> Once deprecated, we'll simply ignore the "page" parameter if it's sent
> by a client, and you'll get the default number of items for the method
> you're calling.
>
> For more information, seehttp://apiwiki.twitter.com/Twitter-API-Documentation. Thanks.

DustyReagan

unread,
Oct 21, 2009, 10:20:27 PM10/21/09
to Twitter Development Talk
Is page deprecation still scheduled to happen on Oct. 26th?

Is this deprecation happening on all methods that have the cursor
parameter enabled?

-Dusty


On Oct 8, 5:26 am, Kyle Mulka <repalvigla...@yahoo.com> wrote:
> Will thepageparameter on /statuses/user_timeline (or on any of the
> other timeline methods) be deprecated as well?https://twitterapi.pbworks.com/Twitter-REST-API-Method%3A-statuses-us...
>
> I've noticed a lot of failures on /statuses/user_timeline recently.
> Instead of thepageparameter, is it better to use max_id?
>
> --
> Kyle Mulkahttp://twilk.com- put your friends faces on your Twitter background

Rich

unread,
Oct 22, 2009, 4:17:18 AM10/22/09
to Twitter Development Talk
I hope not, Apple are being especially slow at approving my update at
the moment that includes the cursor changes!

On Oct 22, 3:20 am, DustyReagan <dustyrea...@gmail.com> wrote:
> Is page deprecation still scheduled to happen on Oct. 26th?
>
> Is this deprecation happening on all methods that have the cursor
> parameter enabled?
>
> -Dusty
>
> On Oct 8, 5:26 am, Kyle Mulka <repalvigla...@yahoo.com> wrote:
>
> > Will thepageparameter on /statuses/user_timeline (or on any of the
> > other timeline methods) be deprecated as well?https://twitterapi.pbworks.com/Twitter-REST-API-Method%3A-statuses-us...
>
> > I've noticed a lot of failures on /statuses/user_timeline recently.
> > Instead of thepageparameter, is it better to use max_id?
>
> > --
> > Kyle Mulkahttp://twilk.com-put your friends faces on your Twitter background

DustyReagan

unread,
Oct 24, 2009, 1:49:37 AM10/24/09
to Twitter Development Talk
Bump.

Anyone know if page deprecation still scheduled to happen on Oct.
26th?


On Oct 22, 3:17 am, Rich <rhyl...@gmail.com> wrote:
> I hope not, Apple are being especially slow at approving my update at
> the moment that includes the cursor changes!
>
> On Oct 22, 3:20 am, DustyReagan <dustyrea...@gmail.com> wrote:
>
>
>
> > Is page deprecation still scheduled to happen on Oct. 26th?
>
> > Is this deprecation happening on all methods that have the cursor
> > parameter enabled?
>
> > -Dusty
>
> > On Oct 8, 5:26 am, Kyle Mulka <repalvigla...@yahoo.com> wrote:
>
> > > Will thepageparameter on /statuses/user_timeline (or on any of the
> > > other timeline methods) be deprecated as well?https://twitterapi.pbworks.com/Twitter-REST-API-Method%3A-statuses-us...
>
> > > I've noticed a lot of failures on /statuses/user_timeline recently.
> > > Instead of thepageparameter, is it better to use max_id?
>
> > > --
> > > Kyle Mulkahttp://twilk.com-putyour friends faces on your Twitter background

Tim Haines

unread,
Oct 26, 2009, 6:18:43 AM10/26/09
to twitter-deve...@googlegroups.com
I guess they haven't indicated otherwise, so you'd have to presume it's still going to go ahead?

I half expect they'll delay it due to performance issues raised, but I wouldn't bank on it.

Tim.

John Kalucki

unread,
Oct 26, 2009, 10:04:19 AM10/26/09
to Twitter Development Talk
Internal discussions indicate that removing the backing store that
supports this method remains a priority. The API will be disabled to
allow the backing store to be decommissioned.

-John Kalucki
http://twitter.com/jkalucki
Services, Twitter Inc.



On Oct 26, 3:18 am, Tim Haines <tmhai...@gmail.com> wrote:
> I guess they haven't indicated otherwise, so you'd have to presume it's
> still going to go ahead?
>
> I half expect they'll delay it due to performance issues raised, but I
> wouldn't bank on it.
>
> Tim.
>
> On Sat, Oct 24, 2009 at 6:49 PM, DustyReagan <dustyrea...@gmail.com> wrote:
>
> > Bump.
>
> > Anyone know if page deprecation still scheduled to happen on Oct.
> > 26th?
>
> > On Oct 22, 3:17 am, Rich <rhyl...@gmail.com> wrote:
> > > I hope not, Apple are being especially slow at approving my update at
> > > the moment that includes the cursor changes!
>
> > > On Oct 22, 3:20 am, DustyReagan <dustyrea...@gmail.com> wrote:
>
> > > > Is page deprecation still scheduled to happen on Oct. 26th?
>
> > > > Is this deprecation happening on all methods that have the cursor
> > > > parameter enabled?
>
> > > > -Dusty
>
> > > > On Oct 8, 5:26 am, Kyle Mulka <repalvigla...@yahoo.com> wrote:
>
> > > > > Will thepageparameter on /statuses/user_timeline (or on any of the
> > > > > other timeline methods) be deprecated as well?
> >https://twitterapi.pbworks.com/Twitter-REST-API-Method%3A-statuses-us...
>
> > > > > I've noticed a lot of failures on /statuses/user_timeline recently.
> > > > > Instead of thepageparameter, is it better to use max_id?
>
> > > > > --
> > > > > Kyle Mulkahttp://twilk.com-putyourfriends faces on your Twitter
Reply all
Reply to author
Forward
0 new messages