Real-time Activity Stream (Pooled) API 1.1

This API returns the same data as the Real-time Activity Stream API, but it does so in a more conventional fashion. Instead of a real stream, this version of the API can be queried using standard periodic short lived http requests and will return video data in chunks rather than a continuous stream.

Demo of the stream in use

URL

• The URL where you can access this API looks like:
  http://apis.videosurf.com/view_stream_pooled/v1.1/?filter_level=strict_safe

Authentication

• Each use of any VideoSurf API is subject to the Terms Of Use and requires you to provide a valid client_id and client_key
• client_id - A human readable client identifier. Please pick something short and descriptive.
  • Required
  • Type: String
  • Example: client_id=your_domain
• client_key - This is an authorization token issued to you by VideoSurf. Obtain one here.
  • Required
  • Type: String
  • Example: client_key=900d77b8e40e60f0113dccc2973f2ed1

Inputs

• filter_level - You can filter the stream in various ways
  • Optional
  • Type: String
  • Default: moderate_safe
  • Possible Values:

    moderate_safe	Filters out explicit content
    strict_safe	Filters out explicit and even moderately explicit content
    raw	The raw stream of all videos viewed on VideoSurf, including explicit content
    explicit_only	Return only explicit content ;

  • Example: filter_level=strict_safe

Output

This API will return a chunk of videos that have been recently viewed on VideoSurf. Depending on the amount of video viewing volume happening on the VideoSurf site at any given time, the size of this chunk and the interval of time between updates to the list will change as necessary. Videos returned in this chunk will be listed in the order in which they were viewed on the site. Oldest first.
• last_update_time - Unix timestamp indicating when this list was last updated
• next_update_time - Unix timestamp indicating when this list will next be updated. Until this time occurs, subsequent calls to this API will return the same exact data and should be avoided. You should wait until this time before asking for more videos.
• videos - An array of video information. Each video has the following information:
  • video_id - A unique ID identifying this video in the VideoSurf index.
  • title - Title of the video.
  • url - URL of the VideoSurf video page.
  • source - Display name of the provider's site. (e.g. Hulu, Youtube)
  • thumbnail - URL of the default VideoSurf thumbnail for this video.
  • length - Duration of the video in seconds.
  • entity_ids - A comma separated list of entities related to this video, may be empty