Lexicon Garden

place.stream.media.getVideo

Get a hydrated view of a place.stream.video record — the record itself plus author info plus aggregated view counts summed across every reporting node we've indexed. View counts come from place.stream.media.viewCount records; consumers see one number per metric, with the underlying multi-reporter detail collapsed away.

Repository @stream.place did:plc:rbvrr34edl5ddpuwcubjiost not from the namespace authority
Details · query
Kindquery
Authoritymedia.stream.place
Indexed
Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

uri

requiredstring · at-uri

AT-URI of the place.stream.video record.

Output

application/json

schema

ref
Reference

Errors

VideoNotFound

No record indexed at the supplied AT-URI.

#videoView

object

Properties

cid

requiredstring · cid

likeCount

requiredinteger

Total number of place.stream.like records whose subject is this video. Always present; zero when none, so consumers can render a count unconditionally.

  • minimum: 0

record

requiredunknown

tracks

array

uri

requiredstring · at-uri

viewCounts

requiredref

Aggregated view counts across every indexed reporter. Always present; zero-valued (count=0, reporters=0) when no place.stream.media.viewCount records have been observed yet, so consumers can render a count unconditionally.

Reference

#viewCountSummary

object

Sums across every place.stream.media.viewCount record indexed for this video, regardless of reporter or window. The underlying records are window-bounded; the consumer sees a running total.

Properties

bytes

requiredinteger

Sum of bytes transferred across every track row in every indexed report.

  • minimum: 0

count

requiredinteger

Sum of `count` across every indexed report.

  • minimum: 0

durationMs

requiredinteger

Sum of playback duration (ms) across every track row in every indexed report.

  • minimum: 0

reporters

requiredinteger

Number of distinct streamplace nodes that have contributed at least one viewCount record for this video.

  • minimum: 0

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • place.stream.media.viewCount

    record not from the namespace authority

    A streamplace node's report of view counts for one place.stream.video over a closed time window. Published in the reporting node's server repo (not the streamer's), so a video served by multiple nodes accumulates multiple records — consumers are expected to sum across trusted reporters. The rkey is conventionally `<windowStart-as-tid>-<video-rkey>` so re-running the aggregator over the same window is idempotent. Counts represent the reporting node's best effort given the data it has; the `tracks

  • place.stream.live.viewCount

    record not from the namespace authority

    Current view count for a livestream on a particular server.

  • place.stream.media.listVideos

    query not from the namespace authority

    A streamer's place.stream.video records (read from their PDS) and this node's uploads for them: everything updateVideo, deleteVideo and publishVideo take. The caller must be the streamer or hold livestream.manage from them.

  • place.stream.media.getVideoList

    query not from the namespace authority

    List videos newest first. Scoped to a single repo when `repo` is supplied; otherwise lists videos across every indexed repo. Returns hydrated video views with author info and view counts.

  • place.stream.live.viewerCount

    record

    Current viewer count for a livestream on a particular server. Record keys are streamer_did::server_did by convention.