network.bsky.jetstream.getBlock Documentation (EN)

main query

Download a single block within a sealed segment file by index. Returns the raw zstd-compressed block frame exactly as stored on disk.

Parameters

blockIndex integer Required

Zero-based block index within the segment. Must be < the segment's block_count.

segment string Required

The sealed segment filename, e.g. seg_000000002a.jss.

Output

Encodingapplication/octet-stream

Errors

SegmentNotFound No sealed segment exists for the given name.

BlockNotFound blockIndex is >= the segment's block_count.

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

blockIndex * Zero-based block index within the segment. Must be < the segment's block_count.

segment * The sealed segment filename, e.g. seg_000000002a.jss.

View raw schema

{
  "description": "Download a single block within a sealed segment file by index. Returns the raw zstd-compressed block frame exactly as stored on disk.",
  "errors": [
    {
      "description": "No sealed segment exists for the given name.",
      "name": "SegmentNotFound"
    },
    {
      "description": "blockIndex is >= the segment's block_count.",
      "name": "BlockNotFound"
    }
  ],
  "output": {
    "encoding": "application/octet-stream"
  },
  "parameters": {
    "properties": {
      "blockIndex": {
        "description": "Zero-based block index within the segment. Must be < the segment's block_count.",
        "minimum": 0,
        "type": "integer"
      },
      "segment": {
        "description": "The sealed segment filename, e.g. seg_000000002a.jss.",
        "type": "string"
      }
    },
    "required": [
      "segment",
      "blockIndex"
    ],
    "type": "params"
  },
  "type": "query"
}