Analysis

Findings

Aggregated snag counts for up to the most recently active heatmap cohorts. Deliberate validation visits are excluded. These are heuristics about observed behavior, not claims about emotion or conversion. groupBy=revision folds the automatic release and page version ids (auto-..., unversioned) of one page group, revision, device class and variant into one row and keeps releases the team named or logged apart; the default, cohort, returns one row per heatmap cohort.

Required token scopes are listed in x-hootlens-scopes. A signed-in person needs the matching permission on the site instead (the viewer and editor roles are presets of the permissions).

get/v1/projects/{projectId}/findings

Request

  • Base URL: https://hootlens-api-368877148687.us-east1.run.app
  • URL: https://hootlens-api-368877148687.us-east1.run.app/v1/projects/{projectId}/findings
  • Auth: HTTP bearer

Path parameters

projectIdstring required

An identifier: 1 to 80 letters, digits, underscores or hyphens.

The project ID. Project IDs are public identifiers, not secrets.

Query parameters

groupBy'cohort' | 'revision'

cohort (default): one row per heatmap cohort. revision: fold automatic version ids of one page revision and device class.

detail'true' | 'false'

true lists every folded cohort key (cohortKeys) and release or page version id (versionIds) on folded rows. Default false: only their counts (foldedCohorts, versionCount).

Response

The findings.

samplestring required
grouping'cohort' | 'revision'
excludedControlledRecordingsinteger
segmentsinteger required
signalobject required

Observed behavior with evidence, never a psychological diagnosis.

pileUpsOnNonControlsinteger

Pile-ups on listed elements that carry interactive: false, summed over the rows. Absent when none.

cohortsobject[] required

Changes

No recorded changes to this operation across all 1 revision of this API.