ChronicleSchema
Used on
AudioObject, VideoObject, MusicRecording, PodcastEpisode and their subclasses
Expected type
Text
Values
At most one value
Required
No

In other vocabularies

VocabularyTerm
schema.org Same as duration
Activity Streams 2.0 Same as duration

Examples

Listening to a track

A ListenAction for one play in Spotify's recently played list.

{
  "@type": "ListenAction",
  "@key": ["@type", "source", "agent.handle", "object.sourceId", "timestamp"],
  "source": "spotify",
  "timestamp": "2026-05-09T16:04:51.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "handle"],
    "source": "spotify",
    "handle": "pat",
    "name": "Pat Example",
    "url": "https://open.spotify.com/user/pat",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "MusicRecording",
    "@key": ["@type", "source", "sourceId"],
    "source": "spotify",
    "sourceId": "6mT8qR2vN5xK9pL3bH7wC4",
    "url": "https://open.spotify.com/track/6mT8qR2vN5xK9pL3bH7wC4",
    "name": "Morning Light",
    "duration": "PT215S",
    "artist": [
      {
        "@type": "MusicGroup",
        "@key": ["@type", "source", "sourceId"],
        "source": "spotify",
        "sourceId": "4kQ7wN2pR8sT1vX3yZ5bC6",
        "url": "https://open.spotify.com/artist/4kQ7wN2pR8sT1vX3yZ5bC6",
        "name": "The Example Band"
      }
    ],
    "inAlbum": {
      "@type": "MusicAlbum",
      "@key": ["@type", "source", "sourceId"],
      "source": "spotify",
      "sourceId": "1bD4fG7hJ9kL2mN5pQ8rS3",
      "url": "https://open.spotify.com/album/1bD4fG7hJ9kL2mN5pQ8rS3",
      "name": "Morning Songs",
      "datePublished": "2024-03-01"
    },
    "emblem": {
      "@type": "ImageObject",
      "@key": ["url"],
      "url": "https://images.example.com/covers/morning-songs.jpg",
      "width": 640,
      "height": 640
    }
  }
}

Liking a video

A LikeAction from the YouTube API: you liked a video.

{
  "@type": "LikeAction",
  "@key": ["@type", "source", "agent.handle", "object.sourceId", "timestamp"],
  "source": "youtube",
  "timestamp": "2026-05-09T20:14:05.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "handle"],
    "source": "youtube",
    "handle": "UCexampleOwner0000000000",
    "url": "https://www.youtube.com/channel/UCexampleOwner0000000000",
    "name": "Pat Example",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "VideoObject",
    "@key": ["@type", "source", "sourceId"],
    "source": "youtube",
    "sourceId": "vid00000001",
    "url": "https://www.youtube.com/watch?v=vid00000001",
    "name": "Fixing a bike chain in five minutes",
    "duration": "PT5M12S",
    "datePublished": "2025-03-14T16:00:00Z",
    "emblem": {
      "@type": "ImageObject",
      "@key": ["url"],
      "url": "https://i.example.com/vi/vid00000001/maxresdefault.jpg"
    },
    "author": [
      {
        "@type": "Agent",
        "@key": ["@type", "source", "handle"],
        "source": "youtube",
        "handle": "UCexampleWorkshop0000000",
        "url": "https://www.youtube.com/channel/UCexampleWorkshop0000000",
        "name": "Corner Bike Workshop"
      }
    ]
  }
}

Publishing a video

A PublishAction for a video uploaded to your channel.

{
  "@type": "PublishAction",
  "@key": ["@type", "source", "result.sourceId"],
  "source": "youtube",
  "timestamp": "2025-08-01T12:00:00.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "handle"],
    "source": "youtube",
    "handle": "UCexampleOwner0000000000",
    "sameAs": ["@me"]
  },
  "result": {
    "@type": "VideoObject",
    "@key": ["@type", "source", "sourceId"],
    "source": "youtube",
    "sourceId": "vid00000002",
    "url": "https://www.youtube.com/watch?v=vid00000002",
    "name": "Summer ride",
    "duration": "PT2M3S"
  }
}

URI https://schema.chronicle.app/duration · Suggest a change

Esc

↑↓ to move↵ to open/ or ⌘K to search