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 – Playlists

JSON REST API – version 2 – Playlists

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/playlists application/json
GET https://connect.telvue.com/api/v2/playlists/:id 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/playlists/:id replace :id with the id of the Connect Playlist being requested 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 Playlists Index Request:

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

Example JSON Response:

{
  "playlists":
    [
      {
        "id":836,
        "name":"Test Playlist",
        "description":"A long text description of this playlist",
        "user_id":24,
        "organization_id":13,
        "thumbnail_large":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/playlists/836/framegrab/framegrab_6bd37c13-a487-4235-8c69-169b9a51f092.jpg",
        "thumbnail_medium":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/playlists/836/vod_thumb_hd/vod_thumb_hd_5ac1c2f0-d51a-49be-9513-5e97b5542546.jpg",
        "thumbnail_small":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/playlists/836/vod_thumb_sd/vod_thumb_sd_16d95875-67dc-40ba-8f0c-4af1ecbccc12.jpg",
        "thumbnail_tiny":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/playlists/836/thumb/thumb_e8e08a0c-88ca-4f7b-a4cb-99f56f6fbb98.jpg",
        "playables_count":2
      }
    ]
}

Example cURL GET Playlist Request:

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

Example JSON Response:

{
  "playlist":
    {
      "id":836,
      "name":"Test Playlist",
      "description":"A long text description of this playlist",
      "user_id":24,
      "organization_id":13,
      "thumbnail_large":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/playlists/836/framegrab/framegrab_6bd37c13-a487-4235-8c69-169b9a51f092.jpg",
      "thumbnail_medium":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/playlists/836/vod_thumb_hd/vod_thumb_hd_5ac1c2f0-d51a-49be-9513-5e97b5542546.jpg",
      "thumbnail_small":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/playlists/836/vod_thumb_sd/vod_thumb_sd_16d95875-67dc-40ba-8f0c-4af1ecbccc12.jpg",
      "thumbnail_tiny":"https://connect.telvue.com/alternate_assets/ae9b0680-0b93-0133-e301-52540084dd42/playlists/836/thumb/thumb_e8e08a0c-88ca-4f7b-a4cb-99f56f6fbb98.jpg",
      "playables_count":2
    }
}
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 – VideosJSON REST API – version 2 – Playlist Items

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