Timelines

Timelines are personalized lists of posts, tailored for each account according to their social graph.

Account Timeline

The account timeline is the aggregated list of items (root posts, comments, reposts) generated from the account's social graph. The timeline is organized based on relevance and recency.

GraphQL
React
TypeScript

You can use the timeline query to fetch the account timeline.

You MUST be authenticated as Account Owner or Account Manager to make this request.

query {  timeline(request: {    account: "0x1234…"    # optional, defaults to the Global Feed address    # forFeeds: [EvmAddress]    filter: {      # optional, the timeline event type      # eventType: [TimelineEventItemType!]      # optional, filter by metadata      metadata: {        mainContentFocus: [IMAGE]
        # optional, filter by tags        # tags: PostMetadataTagsFilter
        # optional, filter by content warning        # contentWarning: PostMetadataContentWarningFilter      }    }  }) {    items {      id,      primary {        ...Post      }      comments {        ...Post      }      reposts {        ...Repost      }    }    pageInfo {      prev      next    }  }}

Where:

id: The timeline event identifier.
primary: The primary post of the timeline event.
comments: The list of comments that are related to the primary post. Note: it's not always parent -child relation, can be a nested comment.
reposts: The list of reposts related the primary post.

The Fetch Posts guide goes into details of how to fetch Post and Repost details.

See the Pagination guide for more information on how to handle paginated results.

Timeline Highlights

Timeline Highlights is a curated selection of posts from an account timeline that have received the most engagement. This feature is useful for quickly catching up on the most popular content.

GraphQL
React
TypeScript

You can use the timelineHighlights query to fetch most popular posts and quotes from an account timeline.

query {  timelineHighlights(request: {    account: "0x1234…"    # optional, defaults to the Global Feed address    # forFeeds: [EvmAddress]    filter: {      # optional, filter by metadata      metadata: {        mainContentFocus: [IMAGE]
        # optional, filter by tags        # tags: PostMetadataTagsFilter
        # optional, filter by content warning        # contentWarning: PostMetadataContentWarningFilter      }    }  }) {    items {      ...Post    }    pageInfo {      prev      next    }  }}

The Fetch Posts guide goes into details of how to fetch Post details.

See the Pagination guide for more information on how to handle paginated results.