Profile: newscast

Profile Schema

The newscast profile designates a document that always contains audio marked as newscast and is considered to represent a more ephemeral type of content that has a limited useful lifetime.

Structure

The newscast profile specifies the following attribute:

Name Type Required? Explanation
expirationDateTime date-time string Yes Newscast content should stopped being used after the expiration time except as historical information. Use the RFC3339 format set in UTC time (ex: 2021-11-04T08:49:00Z) (ex: 2021-11-04T08:49:00Z). See our tutorial on UTC time for more help.

A newscast document must also have the has-audio profile, which specifies an audio attribute. newscast requires that one of the links in the audio array contains one of the following rel values:

  • npr-newscast: a newscast published by NPR, notably the National newscast.
  • station-newscast: newscast streams published by Network Stations.
  • consortium-newscast: a network stream published by Network Consortiums for use by Stations.
  • newscast (deprecated): no longer used in favor of the more specific newscast types above.

Example newscast document

{
  "id": "npr202306220800",
  "profiles": [
    {
      "href": "/v1/profiles/newscast",
      "rels": [
        "type"
      ]
    },
    {
      "href": "/v1/profiles/has-audio"
    },
    {
      "href": "/v1/profiles/listenable"
    },
    {
      "href": "/v1/profiles/document"
    },
    {
      "href": "/v1/profiles/publishable"
    }
  ],
  "brandings": [
    {
      "href": "https://npr-organization-host.org/organizations/s1"
    }
  ],
  "owners": [
    {
      "href": "https://npr-organization-host.org/organizations/s1"
    }
  ],
  "assets": {
    "5678": {
      "id": "5678",
      "profiles": [
        {
          "href": "/v1/profiles/audio"
        },
        {
          "href": "/v1/profiles/document"
        }
      ],
      "title": "National Newscast for June 22nd, 2023 at 8am EST.",
      "enclosures": [
        {
          "href": "https://npr-audio-host.org/newscast/2023062208.mp3",
          "type": "audio/mpeg"
        }
      ]
    }
  },
  "audio": [
    {
      "href": "#/assets/5678",
      "rels": [
        "newscast"
      ]
    }
  ],

  "expirationDateTime": "2023-06-22T09:10:00Z"
}

© 2024 npr