ChronicleSchema

In other vocabularies

VocabularyTerm
schema.org A kind of LikeAction
Activity Streams 2.0 A kind of Like

Properties

PropertyExpected typeDescription
From Action
agent one Agent Who performed the action. An action whose performer is unknown has no agent.
endTime one DateTime When the action ended. A date gives the end at that date's precision and includes the whole period, so 1990 runs to the end of 1990.
instrument many Entity The tool, device, application, or model used to perform an action. The agent is who acted. The instrument is what they used. When only the kind of device is known, it is a ProductModel rather than a Device.
location one Location or Place Where the action happened, or where the entity or event is.
object one Entity The entity an action was carried out on, such as the article read, the photo shared, or the place visited. For a movement, such as a TravelAction, the object is where it began.
result one Entity What the action produced, such as a work or a session. Seen from what it produced, the action is its resultOf value.
startTime one DateTime When the action started. A date gives the start at that date's precision.
target one Entity What an action is directed toward, as distinct from the object it is carried out on. Adding to or removing from a collection targets the collection. A movement targets where it ended, and its object is where it began.
timestamp one DateTime When the action occurred.
From Base
source one Text The source that describes the entity or action, such as things-todo. Identifiers such as sourceId are unique within it.
sourceId one Text The identifier the source gives an entity or action, such as a record ID or message ID. It is unique only within its source.

Examples

Liking a post

You liked someone else's Instagram post.

{
  "@type": "LikeAction",
  "@key": ["@type", "source", "agent.handle", "object.sourceId"],
  "source": "instagram",
  "timestamp": "2024-08-30T06:40:00.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "handle"],
    "source": "instagram",
    "handle": "sam.rivera",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Post",
    "@key": ["@type", "source", "sourceId"],
    "source": "instagram",
    "sourceId": "C0ExampleA1",
    "url": "https://www.instagram.com/p/C0ExampleA1/",
    "body": "Café vibes",
    "author": [
      {
        "@type": "Agent",
        "@key": ["@type", "source", "handle"],
        "source": "instagram",
        "handle": "alexchen",
        "url": "https://www.instagram.com/alexchen"
      }
    ]
  }
}

Liking a tweet

You liked someone else's tweet.

{
  "@type": "LikeAction",
  "@key": ["@type", "source", "object.sourceId"],
  "source": "twitter",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "sourceId"],
    "source": "twitter",
    "sourceId": "111",
    "handle": "owner_example",
    "name": "Owner Example",
    "url": "https://twitter.com/owner_example",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Post",
    "@key": ["@type", "source", "sourceId"],
    "source": "twitter",
    "sourceId": "9876543210987654321",
    "body": "A tweet I liked from someone else"
  }
}

Saving an album

Saving an album to a Spotify library is a LikeAction, timed by when the album was saved.

{
  "@type": "LikeAction",
  "@key": ["@type", "source", "agent.handle", "object.sourceId", "timestamp"],
  "source": "spotify",
  "timestamp": "2026-04-02T12:00:00.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": "MusicAlbum",
    "@key": ["@type", "source", "sourceId"],
    "source": "spotify",
    "sourceId": "1bD4fG7hJ9kL2mN5pQ8rS3",
    "url": "https://open.spotify.com/album/1bD4fG7hJ9kL2mN5pQ8rS3",
    "name": "Morning Songs",
    "datePublished": "2024-03-01",
    "artist": [
      {
        "@type": "MusicGroup",
        "@key": ["@type", "source", "sourceId"],
        "source": "spotify",
        "sourceId": "4kQ7wN2pR8sT1vX3yZ5bC6",
        "url": "https://open.spotify.com/artist/4kQ7wN2pR8sT1vX3yZ5bC6",
        "name": "The Example Band"
      }
    ]
  }
}

A loved track

A LikeAction for a track the listener loved on Last.fm, keyed by the timestamp when they loved it.

{
  "@type": "LikeAction",
  "@key": ["@type", "source", "timestamp"],
  "source": "lastfm",
  "timestamp": "2026-04-18T21:05:33.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "handle"],
    "source": "lastfm",
    "handle": "sam_listens",
    "url": "https://www.last.fm/user/sam_listens",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "MusicRecording",
    "@key": ["url"],
    "url": "https://www.last.fm/music/Other+Example/_/Harbour+Lights",
    "name": "Harbour Lights",
    "artist": [
      {
        "@type": "MusicGroup",
        "@key": ["url"],
        "source": "lastfm",
        "name": "Other Example",
        "url": "https://www.last.fm/music/Other+Example"
      }
    ]
  }
}

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

Liking a post on Bluesky

A LikeAction for a post you liked on Bluesky.

{
  "@type": "LikeAction",
  "@key": ["@type", "source", "sourceId"],
  "source": "bluesky",
  "sourceId": "did:plc:k3v9x2m7q4w8r1t6y5z0abcd/app.bsky.feed.like/3lcr4m8tnvk2b",
  "timestamp": "2026-03-15T09:12:03.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "sourceId"],
    "source": "bluesky",
    "sourceId": "did:plc:k3v9x2m7q4w8r1t6y5z0abcd",
    "name": "Sam Rivera",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Post",
    "@key": ["@type", "source", "sourceId"],
    "source": "bluesky",
    "sourceId": "did:plc:p8n2c5h7j1g4f6d3s9a0wxyz/app.bsky.feed.post/3lcq9w2kd7s2c",
    "body": "First frost on the community garden this morning.",
    "author": [
      {
        "@type": "Agent",
        "@key": ["@type", "source", "sourceId"],
        "source": "bluesky",
        "sourceId": "did:plc:p8n2c5h7j1g4f6d3s9a0wxyz",
        "name": "Alex Chen"
      }
    ],
    "contains": [
      {
        "@type": "ImageObject",
        "@key": ["url"],
        "url": "https://cdn.example.com/img/frost.jpg",
        "width": 2000,
        "height": 1500,
        "description": "Frost on kale leaves"
      }
    ]
  }
}

Starring a feed item in Google Reader

You starred a feed item.

{
  "@type": "LikeAction",
  "@key": ["@type", "source", "object.sourceId", "agent.sourceId"],
  "source": "google-reader",
  "timestamp": "2010-01-01T17:42:08.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source", "sourceId"],
    "source": "google-reader",
    "sourceId": "01234567890123456789",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Article",
    "@key": ["@type", "source", "sourceId"],
    "source": "google-reader",
    "sourceId": "tag:google.com,2005:reader/item/5d0cb0a4e1f2a3b4",
    "url": "https://trails.example.com/2010/01/lost-lake",
    "name": "Lost Lake in winter",
    "body": "<p>The trail to Lost Lake stays open all winter.</p>"
  }
}

Liking a post

A LikeAction for the like button, from a Facebook export.

{
  "@type": "LikeAction",
  "@key": ["@type", "source", "timestamp", "agent.name", "object.url"],
  "source": "facebook",
  "timestamp": "2026-05-09T18:22:07.000Z",
  "agent": {
    "@type": "Agent",
    "@key": ["@type", "source"],
    "source": "facebook",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Post",
    "@key": ["@type", "source", "url"],
    "source": "facebook",
    "url": "https://www.facebook.com/alex.morgan.example/posts/555000111",
    "author": [
      {
        "@type": "Person",
        "@key": ["@type", "source", "name"],
        "source": "facebook",
        "name": "Alex Morgan"
      }
    ]
  }
}

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

Esc

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