app.bsky.feed.getTimeline Documentation (EN)

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.

Output

Encodingapplication/json

cursor string Optional

No description available.

feed array Required

No description available.

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

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

cursor

limit

View raw schema

{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "feed"
      ],
      "properties": {
        "feed": {
          "type": "array",
          "items": {
            "ref": "app.bsky.feed.defs#feedViewPost",
            "type": "ref"
          }
        },
        "cursor": {
          "type": "string"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 100,
        "minimum": 1
      },
      "cursor": {
        "type": "string"
      },
      "algorithm": {
        "type": "string",
        "description": "Variant 'algorithm' for timeline. Implementation-specific. NOTE: most feed flexibility has been moved to feed generator mechanism."
      }
    }
  },
  "description": "Get a view of the requesting account's home timeline. This is expected to be some form of reverse-chronological feed."
}