app.bsky.feed.getListFeed Documentation (EN)

main query

Get a feed of recent posts from a list (posts and reposts from any actors on the list). Does not require auth.

Parameters

cursor string Optional

No description available.

limit integer Optional

No description available.

list string at-uri Required

Reference (AT-URI) to the list record.

since string Optional

Return only items newer than the position identified by this cursor value, newest first. Use the startCursor from a previous response. The item at that position is not returned because the caller already holds it. When the bounded range is exhausted, the returned cursor equals this value so that pagination continues below the boundary.

Output

Encodingapplication/json

cursor string Optional

No description available.

feed array Required

No description available.

startCursor string Optional

Cursor identifying the newest item in this page. Pass it as since on a later request to fetch only newer content.

Errors

UnknownList

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

cursor

limit

list * Reference (AT-URI) to the list record.

since Return only items newer than the position identified by this cursor value, newest first. Use the startCursor from a previous response. The item at that position is not returned because the caller already holds it. When the bounded range is exhausted, the returned cursor equals this value so that pagination continues below the boundary.

View raw schema

{
  "description": "Get a feed of recent posts from a list (posts and reposts from any actors on the list). Does not require auth.",
  "errors": [
    {
      "name": "UnknownList"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "cursor": {
          "type": "string"
        },
        "feed": {
          "items": {
            "ref": "app.bsky.feed.defs#feedViewPost",
            "type": "ref"
          },
          "type": "array"
        },
        "startCursor": {
          "description": "Cursor identifying the newest item in this page. Pass it as since on a later request to fetch only newer content.",
          "type": "string"
        }
      },
      "required": [
        "feed"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "cursor": {
        "type": "string"
      },
      "limit": {
        "default": 50,
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "list": {
        "description": "Reference (AT-URI) to the list record.",
        "format": "at-uri",
        "type": "string"
      },
      "since": {
        "description": "Return only items newer than the position identified by this cursor value, newest first. Use the startCursor from a previous response. The item at that position is not returned because the caller already holds it. When the bounded range is exhausted, the returned cursor equals this value so that pagination continues below the boundary.",
        "type": "string"
      }
    },
    "required": [
      "list"
    ],
    "type": "params"
  },
  "type": "query"
}