User Streams goes Production, Site Streams adds Home Timelines

757 views
Skip to first unread message

John Kalucki

unread,
Sep 28, 2010, 3:04:40 PM9/28/10
to twitter-deve...@googlegroups.com
User Streams
=====

After an uneventful beta test period, the User Streams feature of the
Twitter Streaming API is now in regular production. As with all
production APIs, material changes will be pre-announced and
non-backward-compatible changes will be avoided. Developers may
release products against the production endpoint at
http://userstream.twitter.com/2/user.json.

While User Streams is most useful for Desktop Clients, experimentation
in other use cases is encouraged. Note that service integrations, such
as websites and other server-based systems, must not open more than a
very small number of User Streams. Instead, services must use Site
Streams. Follow the product selection guide,
http://dev.twitter.com/pages/streaming_api#products to select the
correct product and avoid access interruptions.

Access to User Streams on betastream.twitter.com is now unsupported,
and the beta test endpoints will be disabled in a few days.


Home Timelines
=====

Site Streams and User Streams now support the "with" parameter to
control the delivery of home timelines. This parameter currently
accepts two values: "users" or "followings".

When set to "users", only messages targeted directly at a user will be
delivered:

* Statuses created by the user
* @mentions and Direct Messages sent to the user
* Retweets and favorites of the user's statuses
* New followings by the user
* New followers of the user
* User's profile updates

When set to "followings", the stream will also include:

* Statuses and retweets created by any of the user's followings
* @mentions from any of the user's followings, subject to the setting
of the "replies" parameter

Site Streams defaults to "users" while User Streams defaults to
"followings". These differing default values may be confusing, but
were chosen to retain backwards compatibility. We recommend that you
explicitly set this parameter to avoid confusion and future
compatibility problems as we refine this API.

John Kalucki http://twitter.com/jkalucki
Mark McBride http://twitter.com/mccv
Cara Meverden http://twitter.com/caramev

Dharmesh

unread,
Sep 28, 2010, 3:42:30 PM9/28/10
to Twitter Development Talk
This is awesome.

Anyone have a simple PHP example yet of working with User Streams?
(Just want to use it for myself for now, to get familiar with it).

Thanks.

Dharmesh Shah
http://twitter.com/dharmesh

On Sep 28, 3:04 pm, John Kalucki <j...@twitter.com> wrote:
> User Streams
> =====
>
> After an uneventful beta test period, the User Streams feature of the
> Twitter Streaming API is now in regular production. As with all
> production APIs, material changes will be pre-announced and
> non-backward-compatible changes will be avoided. Developers may
> release products against the production endpoint athttp://userstream.twitter.com/2/user.json.
>
> While User Streams is most useful for Desktop Clients, experimentation
> in other use cases is encouraged. Note that service integrations, such
> as websites and other server-based systems, must not open more than a
> very small number of User Streams. Instead, services must use Site
> Streams. Follow the product selection guide,http://dev.twitter.com/pages/streaming_api#productsto select the

John Kalucki

unread,
Sep 28, 2010, 4:48:32 PM9/28/10
to twitter-deve...@googlegroups.com
Correction: The endpoint is
https://userstream.twitter.com/2/user.json. User Streams is HTTPS
only.

Michael Ledford

unread,
Sep 29, 2010, 12:10:14 AM9/29/10
to Twitter Development Talk

On Sep 28, 3:04 pm, John Kalucki <j...@twitter.com> wrote:

> Site Streams and User Streams now support the "with" parameter to
> control the delivery of home timelines. This parameter currently
> accepts two values: "users" or "followings".

Is it possible to get both users and followings at the same time? It
seems as if you are saying if you don't provide the with parameter you
will get the 'users' option with the user stream by default. If not
are you allowed to open two user streams one for users and one for
followings? It doesn't seem like the API documentation is updated yet
and is the reason for this clarification.

Sincerely,
Michael

John Kalucki

unread,
Sep 29, 2010, 12:47:04 AM9/29/10
to twitter-deve...@googlegroups.com
Followings is additive to the Users. You can observe the behavior of
these settings on userstream.twitter.com.

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

> --
> Twitter developer documentation and resources: http://dev.twitter.com/doc
> API updates via Twitter: http://twitter.com/twitterapi
> Issues/Enhancements Tracker: http://code.google.com/p/twitter-api/issues/list
> Change your membership to this group: http://groups.google.com/group/twitter-development-talk
>

Reply all
Reply to author
Forward
0 new messages