---
title: "Get posts feed"
method: GET
path: "/v1/posts/feed"
tags: ["posts"]
---

# Get posts feed

`GET /v1/posts/feed`

Retrieve a curated, paginated list of posts.

## Query parameters

- `cursor` string
- `limit` integer
- `includeContent` union
  - boolean
  - string

## Response `200`

Feed items retrieved successfully

- object
  - `items` object[], required — Array of items in this page
    - `post` object, required — The post content
      - `id` string, required — Unique identifier for the post
      - `title` string, required — Title of the post
      - `imageUrl` string, uri — Optional URL to the post's main image
      - `publishedAt` string — Epoch timestamp when the post was published
      - `updatedAt` string — Epoch timestamp when the post was last updated
      - `subtitle` string — Optional subtitle or brief summary
      - `slug` string, required — URL-friendly identifier for the post; accessible at paragraph.com/@[publicationSlug]/[slug]
      - `staticHtml` string — Rendered HTML content of the post
      - `json` string — TipTap JSON representation of the post content structure. This is the source of truth that the staticHtml and markdown is generated from
      - `markdown` string — Markdown source of the post content
      - `coinId` string — ID of the associated coin, if the post is coined
      - `categories` string[] — Categories/tags associated with this post
      - `authors` object[] — Authors of this post
        - `id` string, required — Unique identifier for the user
        - `walletAddress` string — Wallet address of the user
        - `avatarUrl` string, uri — URL to the user's avatar image
        - `publicationId` string, required — ID of the publication this user belongs to
        - `name` string — Display name of the user
        - `bio` string — Brief biography of the user (max 500 characters)
        - `farcaster` object — Farcaster profile information, if linked
          - `username` string, required — Farcaster username
          - `displayName` string, required — Farcaster display name
          - `fid` number, required — Farcaster fid
      - `authorIds` string[] — IDs of the authors of this post
      - `views` number — Total views. Only included when fetching your own posts via GET /v1/posts
      - `status` 'published' | 'draft' | 'scheduled' | 'archived' — Current publish status. Only set on authenticated endpoints (listOwn, getById for your own post). Use this instead of publishedAt to determine publish state — publishedAt is preserved across unpublishing.
    - `publication` object, required — The publication this post belongs to
      - `id` string, required — Unique identifier for the publication
      - `name` string, required — Display name of the publication
      - `ownerUserId` string, required — ID of the user who owns this publication
      - `slug` string, required — URL-friendly identifier for the publication; accessible at paragraph.com/@[slug]
      - `customDomain` string, uri — Custom domain configured for this publication
      - `summary` string — Brief description of the publication (max 500 characters)
      - `logoUrl` string, uri — URL to the publication's logo image
      - `postListType` 'feed' | 'grid' | 'full-post' — Homepage layout. 'feed' is a single-column list of cards, 'grid' is a 3-column grid, 'full-post' shows full posts in a single column.
      - `themeColor` 'default' | 'orange-500' | 'rose-600' | 'pink-500' | 'fuchsia-600' | 'purple-600' | 'violet-600' | 'indigo-600' | 'blue-600' | 'sky-600' | 'cyan-600' | 'teal-600' | 'emerald-600' | 'green-600' | 'lime-600' | 'yellow-700' | 'amber-600' | 'orange-600' | 'stone-800' | 'rose-900' | 'indigo-950' | 'teal-950' | 'lime-950' | 'orange-950' — Theme accent color for the publication
      - `headerFont` 'default' | 'serif' | 'mono' — Font family used for headers
      - `bodyFont` 'default' | 'serif' | 'mono' — Font family used for body text
      - `showMostPopular` boolean — Whether the 'most popular posts' widget is shown
      - `hideStats` boolean — Whether to hide stats like subscriber count, post count, and collects
      - `featuredPost` string — Featured post selector. Use 'latest' for the most recent post, 'popular' for the most-viewed post, 'disabled' to hide the featured slot, or the ID of a specific post in this publication.
      - `disableComments` union — Comment visibility. true disables all comments, false enables them, 'on-platform' hides on-Paragraph comments while keeping Farcaster comments.
        - boolean
        - 'on-platform'
      - `disableHighlights` boolean — Whether to disable highlights on this publication's posts
      - `enableTableOfContents` boolean — Whether the table of contents is enabled on posts
      - `enableSubscribePopup` boolean — Whether to show the subscribe popup to first-time visitors arriving from external links
      - `enableSubscribeScroll` boolean — Whether to show the subscribe popup when first-time visitors scroll a post
      - `pinnedPostIds` string[] — Ordered list of post IDs pinned to the top of the publication's homepage. Pinned posts render in their own section above the regular feed.
      - `emailNotifications` object — Owner-side email notification toggles
        - `newComment` boolean — Email the writer when someone comments on a post
        - `newSubscriber` boolean — Email the writer when a new free subscriber signs up
        - `newPaidSubscriber` boolean — Email the writer when a new paid subscriber signs up
        - `newContentCollected` boolean — Email the writer when someone collects their content
    - `user` object, required — The user who owns the publication this post belongs to
      - `id` string, required — Unique identifier for the user
      - `walletAddress` string — Wallet address of the user
      - `avatarUrl` string, uri — URL to the user's avatar image
      - `publicationId` string, required — ID of the publication this user belongs to
      - `name` string — Display name of the user
      - `bio` string — Brief biography of the user (max 500 characters)
      - `farcaster` object — Farcaster profile information, if linked
        - `username` string, required — Farcaster username
        - `displayName` string, required — Farcaster display name
        - `fid` number, required — Farcaster fid
  - `pagination` object, required
    - `cursor` string — Cursor for fetching the next page of results
    - `hasMore` boolean, required — Whether more results are available
    - `total` number — Total number of items available

## Other responses

- `400` — Invalid request parameters
- `500` — Internal server error

---

[API](https://skmtc.net/paragraph-xyz/apis/paragraph-api.md) · [All operations](https://skmtc.net/paragraph-xyz/apis/paragraph-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paragraph-xyz/paragraph-api/versions/7bbf1b62c1a0/schema)