Stream/search

From Justin.tv API Wiki

Jump to: navigation, search

Returns stream information for the live channels that match a search query. The results are sorted by the current number of viewers, with the most popular channels first.

Interface

URL: http://api.justin.tv/api/stream/search/query.format
Formats: xml, json
Methods: GET
Params: Must include a query. For faster results, consider including limit and offset params (max limit is 100, and limit defaults to 10 if no limit is specified).
Cache: This response is cached for 60 seconds; polling faster than that will yield no new results.
Returns: Stream Object

Examples

[
    {"stream_count":"12",
     "name":"live_user_officecam",
     "embed_count":"0",
     "category":"science_tech",
     "subcategory":"technology",
     "title":"Working hard",
     "channel":{
                "mature":false,
                "channel_url":"http://www.justin.tv/officecam",
                "status":"Working hard",
                "embed_enabled":true,
                "image_url_tiny":"http://s.justin.tv/jtv_user_pictures/officecam-profile_image-0eca8742cd7a4945-50x50.png",
                "subcategory":"technology",
                "category":"science_tech",
                "producer":true,
                "tags":"justintv office",
                "screen_cap_url_huge":"http://static-cdn.justin.tv/previews/live_user_officecam-630x473.jpg",
                "language":"en",
                "title":"The (Justin.tv) Office",
                "image_url_huge":"http://s.justin.tv/jtv_user_pictures/officecam-profile_image-0eca8742cd7a4945-600x600.png",
                "screen_cap_url_large":"http://static-cdn.justin.tv/previews/live_user_officecam-320x240.jpg",
                "subcategory_title":"Technology",
                "id":28559,
                "views_count":1112552,
                "image_url_large":"http://s.justin.tv/jtv_user_pictures/officecam-profile_image-0eca8742cd7a4945-300x300.png",
                "category_title":"Science & Tech",
                "screen_cap_url_medium":"http://static-cdn.justin.tv/previews/live_user_officecam-150x113.jpg",
                "image_url_medium":"http://s.justin.tv/jtv_user_pictures/officecam-profile_image-0eca8742cd7a4945-150x150.png",
                "screen_cap_url_small":"http://static-cdn.justin.tv/previews/live_user_officecam-70x53.jpg",
                "timezone":"US/Pacific",
                "login":"officecam",
                "image_url_small":"http://s.justin.tv/jtv_user_pictures/officecam-profile_image-0eca8742cd7a4945-70x70.png"},
     "featured":true,
     "video_bitrate":295.375,
     "language":"en",
     "video_height":354,
     "updated_on":"Mon Oct 19 11:07:57 2009",
     "embed_ratio":"0.00000000000000000000",
     "id":"5360445",
     "video_width":630,
     "up_time":"Fri Oct 16 09:12:44 2009",
     "stream_type":"live",
     "embed_enabled":true,
     "directory_hidden":false,
     "video_codec":"AVC"},
    ...
]
Client Libraries