app.bsky.feed.getTimeline

bsky-lexicons.bsky.social

Documentation

Get a view of the requesting account's home timeline. This is expected to be some form of reverse-chronological feed.

main query

Get a view of the requesting account's home timeline. This is expected to be some form of reverse-chronological feed.

Parameters

algorithm string Optional

Variant 'algorithm' for timeline. Implementation-specific. NOTE: most feed flexibility has been moved to feed generator mechanism.

cursor string Optional

No description available.

limit integer Optional

No description available.

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.

Try It

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

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Variant 'algorithm' for timeline. Implementation-specific. NOTE: most feed flexibility has been moved to feed generator mechanism.
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 view of the requesting account's home timeline. This is expected to be some form of reverse-chronological feed.",
  "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": {
      "algorithm": {
        "description": "Variant 'algorithm' for timeline. Implementation-specific. NOTE: most feed flexibility has been moved to feed generator mechanism.",
        "type": "string"
      },
      "cursor": {
        "type": "string"
      },
      "limit": {
        "default": 50,
        "maximum": 100,
        "minimum": 1,
        "type": "integer"
      },
      "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"
      }
    },
    "type": "params"
  },
  "type": "query"
}

Lexicon Garden

@