so.sprk.feed.getPostThread

sprk.so

Documentation

Get posts in a thread. Does not require auth, but additional metadata and filtering will be applied for authed requests.

main query

Get posts in a thread. Does not require auth, but additional metadata and filtering will be applied for authed requests.

Parameters

anchor string at-uri Required

Reference (AT-URI) to anchor post record.

cursor string Optional

No description available.

depth integer Optional

How many levels of reply depth should be included in response.

limit integer Optional

No description available.

parentHeight integer Optional

How many levels of parent (and grandparent, etc) post to include.

sort string Optional

Sorting for the thread replies.

Output

Encodingapplication/json
cursor string Optional

No description available.

thread array Required

A flat list of thread items. The depth of each item is indicated by the depth property inside the item.

Errors

NotFound
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
Reference (AT-URI) to anchor post record.
How many levels of reply depth should be included in response.
How many levels of parent (and grandparent, etc) post to include.
Sorting for the thread replies.
View raw schema 
{
  "type": "query",
  "errors": [
    {
      "name": "NotFound"
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "thread"
      ],
      "properties": {
        "cursor": {
          "type": "string"
        },
        "thread": {
          "type": "array",
          "items": {
            "ref": "#threadItem",
            "type": "ref"
          },
          "description": "A flat list of thread items. The depth of each item is indicated by the depth property inside the item."
        },
        "threadgate": {
          "ref": "so.sprk.feed.defs#threadgateView",
          "type": "ref"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "anchor"
    ],
    "properties": {
      "sort": {
        "type": "string",
        "default": "oldest",
        "description": "Sorting for the thread replies.",
        "knownValues": [
          "newest",
          "oldest",
          "top"
        ]
      },
      "depth": {
        "type": "integer",
        "default": 6,
        "maximum": 1000,
        "minimum": 0,
        "description": "How many levels of reply depth should be included in response."
      },
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 100,
        "minimum": 1
      },
      "anchor": {
        "type": "string",
        "format": "at-uri",
        "description": "Reference (AT-URI) to anchor post record."
      },
      "cursor": {
        "type": "string"
      },
      "parentHeight": {
        "type": "integer",
        "default": 80,
        "maximum": 1000,
        "minimum": 0,
        "description": "How many levels of parent (and grandparent, etc) post to include."
      }
    }
  },
  "description": "Get posts in a thread. Does not require auth, but additional metadata and filtering will be applied for authed requests."
}
threadItem object

No description available.

Properties

depth integer Required

The nesting level of this item in the thread. Depth 0 means the anchor item.

uri string at-uri Required

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

View raw schema 
{
  "type": "object",
  "required": [
    "uri",
    "depth",
    "value"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "format": "at-uri"
    },
    "depth": {
      "type": "integer",
      "description": "The nesting level of this item in the thread. Depth 0 means the anchor item."
    },
    "value": {
      "refs": [
        "so.sprk.feed.defs#threadViewPost",
        "so.sprk.feed.defs#notFoundPost",
        "so.sprk.feed.defs#blockedPost"
      ],
      "type": "union"
    }
  }
}

Lexicon Garden

@