Skip to end of metadata
Go to start of metadata


What is the COVE API?


  • is a JSON-based, web API.
  • is a read-only service that provides access to full episodes, clips, and promotions.  
  • is a service that allows you to create applications that use PBS video meta-data.  
  • allows you to create applications that stream PBS videos. 


The current version is v1 and documentation can be found here: COVE API Version 1

Getting Started

We suggest the following to get up to speed:

  1. Read the overview of the conceptual models. This will give you a high-level overview of how the data model works.
  2. Request a key. You'll need a key to actually make any real calls to the API.
  3. Agree to the terms of service.
  4. Follow the sample queries.
  5. Build your own app using the current documentation.
  6. Ask questions and get help if you're stuck.
  7. Tell everyone about your cool app!

Try It Out!

Terms of Service

API Terms of Service

How to Request a Key

  1. Go to
  2. Click 'Login with your PBS Account'
  3. In the popup, click "Create Account" and fill out the form
  4. Once a PBS account has been created you should be logged into the open.PBS site
  5. Fill out the COVE API key request form.
  6. Depending on the request and access, it may take several days to get approval.
    1. In the meantime, you can start writing code using the following public access keys:

      Key: Public-Destination-07c5773f-344f-4dd4-a3d1-e1e85157f821
      Secret: f650d902-5657-4881-a305-ed96ccae551d

What to do, once you obtain your Key and Secret

Once you obtain your key and secret, there are a few ways to use them.  You can:

  1. 'plug' them into one of the various COVE client libraries (e.g. the python COVE API library)
  2. generate a 'signature', using your key and secret, and pass that as a parameter to a COVE API endpoint

How to get help or provide help

We have begun using a Questions and Answers platform in lieu of the previously used forums.  We have found that this keeps the discussion on track and relevant to the information being requested. You can check it out on the open.PBS Answers site

  • No labels