Even further clarifications: Top Tweets are coming to make search results even more relevant. We'll be tuning our ranking algorithms with gusto. Some people will naturally resist these changes. Approach with a zen mind.
When we launch this new feature for the API, it will be opt-in for a transitory period, but the search.twitter.com site will come with these results already baked in. Before implementing in your own applications, you'll be able to see the top results for your favorite queries your self. The Search team is always working on ways of making results more relevant. We recognize that not everyone wants search results with algorithmic ranking of tweets, but we like what we've come up with and we think you'll like it too. Taylor Singletary Developer Advocate, Twitter http://twitter.com/episod On Fri, Mar 19, 2010 at 10:11 AM, davidzimm <davidz...@yahoo.com> wrote: > Bad idea. > > 1) reduces the credibility and thereby the value of the results in > twitter search > 2) who determines which is popular- no matter how you try to calculate > this, someone will figure it out and spam the results. > 3) people are used to searching twitter for breaking news, rather than > "authoritative" results. You'll have to change user expectations. > 4) perhaps this can be an "advanced" setting, rather than a default > practice. > > On Mar 19, 10:37 am, Taylor Singletary <taylorsinglet...@twitter.com> > wrote: > > Hi Developers! > > > > The Search team is working on a beta project that returns the most > popular > > tweets for a query, rather than only the most recent tweets. This is a > beta > > project, but an important first step to surface the most popular tweets > for > > users searching Twitter. > > > > You can expect many improvements as we tune and tweak our algorithms, but > we > > want to give everyone a heads up so we can go over the implications for > > those consuming the search API. > > > > --- New attribute in the payload --- > > > > First of all there will be a new attribute in search result payloads. > Since > > some tweets are popular for a given query while others are simply the > most > > recent results that match the query, we are adding a "metadata" section > to > > specify the type of result that a given result represents. > > > > So for a popular tweet the "result_type" in the "metadata" section will > have > > the value "popular". > > > > Example of a result with a popular tweet: > > > > { > > "results": > > [ > > { > > "profile_image_url":" > http://a1.twimg.com/profile_images/668144840/Elizabeth_Web_normal.jpg";, > > "created_at":"Mon,15 Feb 2010 19:55:18 +0000", > > "from_user":"Elizabeth", > > "to_user_id":null, > > "text":"It's the Griswold family trip to Joshua Tree Park! > > @rsarver @Devon @Jess @noradio @kevinweil", > > "id":9153622261, > > "from_user_id":106309, > > "geo":null, > > "iso_language_code":"en", > > "source":"<a href="http://www.atebits.com/"; > > rel="nofollow">Tweetie</a>", > > "metadata": > > { > > "result_type": "popular" > > } > > } > > > > /* etc ... */ > > > > } > > > > Results that are not popular and represent simply recent query matches > will > > have the "result_type" in the "metadata" section with a value of > "recent". > > > > Example of a recent result: > > > > { > > "results": > > [ > > { > > "profile_image_url":" > http://a3.twimg.com/profile_images/641350353/TimCheekFinger_normal.jpg";, > > "created_at":"Mon, 15 Feb 2010 23:42:45 +0000", > > "from_user":"timhaines", > > "to_user_id":97776, > > "text":"@noradio Nice spot.", > > "id":9160218997, > > "from_user_id":159881, > > "to_user":"noradio", > > "geo":null, > > "iso_language_code":"it", > > "source":"<a href="http://www.atebits.com/"; > > rel="nofollow">Tweetie</a>", > > "metadata": > > { > > "result_type": "recent" > > } > > }, > > > > /* etc ... */ > > > > } > > > > --- Results with popular tweets aren't ordered chronologically --- > > > > Until the popular tweet feature all search results have been sorted > > chronologically, most recent results at the top. If a search query has > any > > popular results, those will be returned at the top, even if they are > older > > than the other results. > > > > Example of a non-chronologically ordered set of results including popular > > results: > > > > { > > "results": > > [ > > { > > "profile_image_url":" > http://a1.twimg.com/profile_images/668144840/Elizabeth_Web_normal.jpg";, > > "created_at":"Mon, 15 Feb 2010 19:55:18 +0000", > > "from_user":"Elizabeth", > > "to_user_id":null, > > "text":"It's the Griswold family trip to Joshua Tree Park! > > @rsarver @Devon @Jess @noradio @kevinweil", > > "id":9153622261, > > "from_user_id":106309, > > "geo":null, > > "iso_language_code":"en", > > "source":"<a href="http://www.atebits.com/"; > > rel="nofollow">Tweetie</a>", > > "metadata": > > { > > "result_type": "popular" > > } > > }, > > { > > "profile_image_url":" > http://a3.twimg.com/profile_images/641350353/TimCheekFinger_normal.jpg";, > > "created_at":"Mon, 15 Feb 2010 23:42:45 +0000", > > "from_user":"timhaines", > > "to_user_id":97776, > > "text":"@noradio Nice spot.", > > "id":9160218997, > > "from_user_id":159881, > > "to_user":"noradio", > > "geo":null, > > "iso_language_code":"it", > > "source":"<a href="http://www.atebits.com/"; > > rel="nofollow">Tweetie</a>", > > "metadata": > > { > > "result_type": "recent" > > } > > } > > > > /* etc ... */ > > > > } > > > > --- Only getting popular results --- > > > > If you *only* care about popular results for a given query term, you can > > provide a "result_type" parameter with the value "popular". Then only > > popular results, if there are any, will be returned. By default, if > > "result_type" isn't provided, all result types will be returned. > > > > --- Never getting popular results --- > > > > Conversely, if you *do not* want to receive popular results, provide a > > "result_type" parameter with the value "recent". Then only recent results > > will be returned. > > > > --- Dealing with popular tweets for refreshing search widgets --- > > > > For those using client side search widgets, by default the first request > > might include popular results. If you want to display these you can use > the > > result_type attribute to visually differentiate them. If you don't want > to > > display these you can always just pass the "result_type" parameter with a > > value of "recent" along with your request and they'll never be included. > > > > In the case that you are displaying them, you may not want to not > redisplay > > them every time your widget refreshes. Each result payload will include > the > > since_id that you should use in subsequent requests to get the latest > > results. If you are using this since_id (which all compliant search > widgets > > should) then the popular results will be excluded in subsequent requests. > > The specific since_id value to pass up to the query string is included in > > the payload. Here are examples in various formats: > > > > json: > > "refresh_url":"?since_id=9290798834&q=i" > > > > atom: > > <link type="application/atom+xml" href=" > http://search.twitter.com/search.atom?q=i&since_id=9290738270"; > > rel="refresh"/> > > > > rss: > > <twitter:refresh_url> > http://search.twitter.com/search.rss?q=i&since_id=9290775688 > > </twitter:refresh_url> > > > > --- Thanks --- > > > > We're excited about this project and will send updates as we get closer > to > > the release date. We're looking forward to your feedback and questions! > > Thank you. > > > > Taylor Singletary (on behalf of the platform & search teams at Twitter) > > Developer Advocate, Twitterhttp://twitter.com/episod > > To unsubscribe from this group, send email to twitter-development-talk+ > unsubscribegooglegroups.com or reply to this email with the words "REMOVE > ME" as the subject. > To unsubscribe from this group, send email to twitter-development-talk+unsubscribegooglegroups.com or reply to this email with the words "REMOVE ME" as the subject.
![http://a1.twimg.com/profile_images/668144840/Elizabeth_Web_normal.jpg"](http://a1.twimg.com/profile_images/668144840/Elizabeth_Web_normal.jpg"){kind=link}
![http://a3.twimg.com/profile_images/641350353/TimCheekFinger_normal.jpg"](http://a3.twimg.com/profile_images/641350353/TimCheekFinger_normal.jpg"){kind=link}