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"
}

© 2025 npr