User Streams goes Production, Site Streams adds Home Timelines
John Kalucki
=====
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
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
> 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
John Kalucki
Michael Ledford
> control the delivery of home timelines. This parameter currently
> accepts two values: "users" or "followings".
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
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
>