800.885.8886 sales@telvue.com
  • Facebook
  • Twitter
  • Facebook
  • Twitter
TelVue
  • Home
  • Products
    • Playback & Automation
      • HyperCaster®
      • ProVue®
        • ProVue® HD
        • ProVue® GFX
        • ProVue® CC
      • TelVue TeleCastTM 2
    • Streaming/Cloud
      • TelVue CloudCast™
      • TelVue Connect™
      • Media Exchange
      • Mobile & OTT Apps
      • TelVue SmartCaption™
    • Digital Signage
      • TelVue InfoVue™
    • Automatic Captioning
      • SmartCaption™
    • Ad Insertion
      • TelVue AdCaster™
  • Solutions
    • Cable/Telco
    • Community Media
    • Media Companies
  • Support
    • Knowledge Base
    • Webinars
    • Training Videos
    • Documentation
    • Contact Support
  • News
    • Blog
    • Press
    • Awards
  • Client Logins
    • Connect/CloudCast
    • InfoVue
  • Contact Us
    • General & Sales
    • Technical Support
Select Page

Connect/CloudCast

Connect User Manual
  • TelVue Connect™ User Manual (v2.6)
  • Organization Settings
  • Getting Started
  • Upload and Transcode Content
  • Enter Metadata
  • Metadata Presets
  • Broadcast Server Integration
  • Distribution
  • Manage Storage Space in Connect
  • Manage User Accounts
  • Email Notifications
  • Publishing and Moderation
  • Create and Schedule Series
  • Fill a Series with Episodes
  • Create and Schedule Playlists
  • TelVue Connect Media Exchange
  • How to Syndicate Content to the Media Exchange
  • Series Syndication
  • Syndication Reports
  • SmartCaption™ Automatic Closed Captioning
  • Custom Language Models
  • SmartCaption™ Caption Translation
  • Manage CloudCast Content
  • Add Live Streams to CloudCast
  • CloudCast Video Player (Connect VOD Player)
  • Share and Embed Videos
  • Manage Connect/CloudCast Categories
  • Add Chapters
  • Add Attachments
  • CloudCast Banner Ads
  • Getting Started with Roku
  • Manage Roku App
  • Getting Started with Apple TV
  • Manage Apple TV App
  • CloudCast MRSS
  • Podcasting
  • Bulk Action Feature Requirements
  • RSS Feeds
  • TelVue Connect Contributors’ Guide (PEG version)
  • TelVue Connect Contributors’ Guide (CableLabs version)
  • Cable Option
CloudCast User Manual
  • Manage CloudCast Content
  • Add Live Streams to CloudCast
  • CloudCast Video Player (Connect VOD Player)
  • Share and Embed Videos
  • Manage Connect/CloudCast Categories
  • Add Chapters
  • Add Attachments
  • CloudCast Banner Ads
  • Getting Started with Roku
  • Manage Roku App
  • Getting Started with Apple TV
  • Manage Apple TV App
  • SmartCaption™ Automatic Closed Captioning
  • Custom Language Models
  • SmartCaption™ Caption Translation
  • CloudCast MRSS
  • CloudCast Training Videos
Media Exchange
  • How to License Content from the Media Exchange
Connect APIs
  • JSON REST API – version 2 – Media
  • JSON REST API – version 2 – Videos
  • JSON REST API – version 2 – Playlists
  • JSON REST API – version 2 – Playlist Items
  • JSON REST API – version 2 – Series
  • JSON REST API – version 2 – Categories
  • JSON REST API – version 2 – Roku Applications
  • Home
  • Knowledge Base
  • Connect/Cloudcast Knowledge Base
  • Connect/CloudCast
  • Connect APIs
  • JSON REST API – version 2 – Videos

JSON REST API – version 2 – Videos

Videos are a blanket term for solid media files and stream sources. Connect’s version 2 API provides a single endpoint to Client callers to retrieve information on playable media and streams published to the Client Application.

Note: The version 2 API does not authenticate using a Connect user’s username and password using HTTP BASIC AUTH. Instead you create a client application using Connect’s web user interface. The client application is issued an ACCESS KEY and SECRET PASSPHRASE. These values must be passed in custom header values on every request.

URLs

Method URL Content Type
GET https://connect.telvue.com/api/v2/videos application/json

Authentication

Type Credentials Required
Connect Custom Connect Issued Access Key and Secret Passphrase

Examples

Using your favorite HTTP tool or library, make a GET request to https://connect.telvue.com/api/v2/videos and include Access Key and Secret Passphrase for the Client Application from which you are making the request.

cURL

The popular cURL tool comes bundled with any Linux, Mac, or UNIX operating system, and there are Windows equivalents.

Example cURL GET Videos Index Request:

curl -k --header "CONNECT-ACCESS-KEY: mykey" 
--header "CONNECT-SECRET-PASSPHRASE: mysecretpassphrase" 
https://connect.telvue.com/api/v2/videos.json

Example JSON Response:

{
  "videos":
    [
      {
        "id":32262,
        "type":"media",
        "title":"darkknightrises-tlr2 h1080p HD",
        "short_summary":"darkknightrises-tlr2 h1080p HD",
        "related_links_count":0,
        "file_attachments_count":0,
        "chapters_count":0,
        "thumbnail_large":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/d1027a2e-7f46-4410-a8ec-e5f54cdf42f3/framegrab/framegrab_3add329d-0710-4b36-8a34-922510e91bfb.jpg",
        "thumbnail_medium":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/d1027a2e-7f46-4410-a8ec-e5f54cdf42f3/vod_thumb_hd/vod_thumb_hd_89895332-0f21-4e87-9f0d-2774fc797ceb.jpg",
        "thumbnail_small":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/d1027a2e-7f46-4410-a8ec-e5f54cdf42f3/vod_thumb_sd/vod_thumb_sd_f2b07f71-08ba-4876-b0df-821ebdf6f908.jpg",
        "thumbnail_tiny":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/d1027a2e-7f46-4410-a8ec-e5f54cdf42f3/thumb/thumb_9ce9a440-7a9a-43af-822c-f39eb52760c8.jpg",
        "created_at":"2016-12-05T14:35:13.338-05:00",
        "updated_at":"2016-12-05T15:27:05.551-05:00",
        "duration_in_seconds":139,
        "sources":
          [
            {
              "url":"https://connectabr-vh.akamaihd.net/i/vod/connect/ae9b0680-0b93-0133-e301-52540084dd42/d1027a2e-7f46-4410-a8ec-e5f54cdf42f3/vod_solid/d2f70f6e-ceb3-4102-930c-c6184114520d_,2250,1000,300,.mp4.csmil/master.m3u8",
              "type":"hls"
            },
            {
              "url":"https://telvuepmd-a.akamaihd.net/vod/connect/ae9b0680-0b93-0133-e301-52540084dd42/d1027a2e-7f46-4410-a8ec-e5f54cdf42f3/vod_solid/d2f70f6e-ceb3-4102-930c-c6184114520d_2250.mp4",
              "type":"http"
            },
            {
              "url":"rtmp://cp.edgefcs.net/ondemand/mp4:connect-vod/ae9b0680-0b93-0133-e301-52540084dd42/d1027a2e-7f46-4410-a8ec-e5f54cdf42f3/vod_solid/d2f70f6e-ceb3-4102-930c-c6184114520d_2250.mp4",
              "type":"rtmp"
            }
          ]
      },
      {
        "id":10646,
        "type":"stream",
        "title":"ACM National Conference LIVE",
        "short_summary":"brought to you by TelVue (https://telvue.com)",
        "related_links_count":0,
        "file_attachments_count":0,
        "chapters_count":0,
        "thumbnail_large":"",
        "thumbnail_medium":"",
        "thumbnail_small":"",
        "thumbnail_tiny":"",
        "created_at":"2016-12-05T16:54:35.870-05:00",
        "updated_at":"2016-12-05T16:54:50.373-05:00",
        "duration_in_seconds":0,
        "sources":
          [
            {
              "url":"http://telvue_liveevent-i.akamaihd.net/hls/live/250268/risingstar/playlist.m3u8",
              "type":"hls"
            }
          ]
      }
    ]
}
Share This Article :
  • Facebook
  • Twitter
  • LinkedIn
  • Pinterest
Still stuck? How can we help?

How can we help?

Updated on December 1, 2022
JSON REST API – version 2 – MediaJSON REST API – version 2 – Playlists

PRODUCTS

  • Playback & Automation
    • HyperCaster®
    • ProVue®
      • ProVue® HD
      • ProVue® GFX
      • ProVue® CC
    • TelVue® TeleCastTM 2
  • Streaming/Cloud
    • TelVue CloudCast™
    • TelVue Connect™
    • Media Exchange
    • Mobile & OTT Apps
    • TelVue SmartCaption™
  • Digital Signage
    • TelVue InfoVue™
  • Automatic Captioning
    • SmartCaption™
  • Ad Insertion
    • AdCaster™

SUPPORT

  • Contact Support
  • Knowledge Base
  • Training Videos
  • Product Documentation

ABOUT

  • Contact Us
  • TelVue News for Hyperlocal Broadcast, PEG news, and TV Technology
  • Press Releases
  • Executive Profiles
  • Sales Team
  • Company
  • Partners

BLOG POSTS

  • HyperCaster Integrated Streaming & Social Streaming Automation
  • Live Dual-language Captioning, Multiple Trim Editing, and Multistreaming Automation with HyperCaster™ 8.3
  • AIO Integrated Streaming, Program Guide & Clock Overlays with HyperCaster™ 8.2
  • Channel Streaming Rights Management with HyperCaster™ 8.1
  • Enhanced Captioning Accuracy and Security with HyperCaster™ 8.0
  • Facebook
  • Twitter
16000 Horizon Way, Suite 100, Mt. Laurel, NJ 08054 - TelVue Corporation ® All Rights Reserved 2020