Skip to main content
Get corpus-level hand-activity measurements.

Authorizations

Authorization
string
header
required

Capability-bearing token issued by a squash operator. Required for curation, exports, dataset registration, and job control when the deployment runs in gated mode; public reads stay open. GET /api/access reports the capabilities a given credential actually carries.

Query Parameters

dataset
string
required

Dataset ID from GET /api/quality/datasets.

analysis
string | null

Opaque analysis token from an earlier response. Omit to use the latest measurement.

Response

Hand-activity shares and coverage

Corpus-level hand-activity shares and measurement coverage.

Each share uses measured_seconds as its denominator and is null when no footage was measured.

analysis
string
required

Opaque measurement token. Matching tokens identify results from the same measurement.

clips
integer
required

Clips included in the analysis.

Required range: x >= 0
dataset
string
required

Dataset ID used in the request.

measured_seconds
number<double>
required

Assessed footage in seconds. This is the denominator for each share.

segments_unassessed
integer
required

Segments that could not be assessed. They are excluded from measured_seconds.

Required range: x >= 0
segments_unusable
integer
required

Segments with an unusable assessment. They are excluded from measured_seconds.

Required range: x >= 0
active_manipulation_share
number<double> | null

Share of measured footage showing active manipulation.

hands_visible_share
number<double> | null

Share of measured footage with at least one camera-wearer hand visible.

two_hands_visible_share
number<double> | null

Share of measured footage with both camera-wearer hands visible.