network.bsky.jetstream.listSegments

bsky-lexicons.bsky.social

Documentation

Enumerate sealed segment files available for download, in ascending index order.

main query

Enumerate sealed segment files available for download, in ascending index order.

Parameters

cursor string Optional

Opaque pagination cursor from a previous response.

limit integer Optional

Maximum number of segment file names to return.

Output

Encodingapplication/json
cursor string Optional

No description available.

segments array Required

No description available.

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
Opaque pagination cursor from a previous response.
Maximum number of segment file names to return.
View raw schema
{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "segments"
      ],
      "properties": {
        "cursor": {
          "type": "string"
        },
        "segments": {
          "type": "array",
          "items": {
            "ref": "#segment",
            "type": "ref"
          }
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "limit": {
        "type": "integer",
        "default": 100,
        "maximum": 1000,
        "minimum": 1,
        "description": "Maximum number of segment file names to return."
      },
      "cursor": {
        "type": "string",
        "description": "Opaque pagination cursor from a previous response."
      }
    }
  },
  "description": "Enumerate sealed segment files available for download, in ascending index order."
}
segment object

No description available.

Properties

checksum string Required

Segment-format xxh3 metadata checksum as 16-char hex; equals the getSegment ETag.

eventCount integer Required

Number of events in the segment.

index integer Required

Zero-based segment index.

maxSeq integer Required

No description available.

maxWitnessedAt integer Required

Latest witnessed-at, unix microseconds.

minSeq integer Required

No description available.

minWitnessedAt integer Required

Earliest witnessed-at, unix microseconds.

name string Required

Segment filename; pass to getSegment.

sizeBytes integer Required

File size in bytes.

View raw schema
{
  "type": "object",
  "required": [
    "name",
    "index",
    "sizeBytes",
    "checksum",
    "eventCount",
    "minSeq",
    "maxSeq",
    "minWitnessedAt",
    "maxWitnessedAt"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Segment filename; pass to getSegment."
    },
    "index": {
      "type": "integer",
      "description": "Zero-based segment index."
    },
    "maxSeq": {
      "type": "integer"
    },
    "minSeq": {
      "type": "integer"
    },
    "checksum": {
      "type": "string",
      "description": "Segment-format xxh3 metadata checksum as 16-char hex; equals the getSegment ETag."
    },
    "sizeBytes": {
      "type": "integer",
      "description": "File size in bytes."
    },
    "eventCount": {
      "type": "integer",
      "description": "Number of events in the segment."
    },
    "maxWitnessedAt": {
      "type": "integer",
      "description": "Latest witnessed-at, unix microseconds."
    },
    "minWitnessedAt": {
      "type": "integer",
      "description": "Earliest witnessed-at, unix microseconds."
    }
  }
}

Lexicon Garden

@