GET /gammas/{gammaId}/analytics

Returns doc-level engagement metrics for a Gamma: views, unique viewers/editors, card count, last opened time, and a 30-day daily breakdown.

Retrieve doc-level engagement metrics for a single Gamma.

Get Gamma analytics

get

Returns doc-level engagement metrics for a Gamma: total views, unique viewers/editors, card count, last opened time, and a 30-day daily unique-viewer breakdown. Requires at least edit permission on the Gamma. When the API key's user has manage permission the metrics cover all viewers (scope: "all"); otherwise they cover only that user's own activity (scope: "self"). Data is eventually consistent (~hourly).

Authorizations

api-key

X-API-KEYstringRequired

API key for authentication

Path parameters

gammaIdstringRequired

The ID of the Gamma — accepts a gamma (file) ID or a page/doc ID (the ID in a gamma.app/docs/ URL).

Example: abc123xyz

Responses

200

Analytics retrieved successfully

application/json

scopestring · enumRequired

Which activity the metrics cover: all — every viewer of the Gamma (the API key's user has manage permission); self — only the API key user's own activity (edit permission).

Example: allPossible values:

gammaIdstringRequired

The Gamma (file) ID

Example: abc123xyz

totalViewsnumberRequired

Total number of view events, including repeat opens by the same viewer.

Example: 342

uniqueViewersnumberRequired

Total unique viewers (authenticated + anonymous)

Example: 128

uniqueEditorsnumberRequired

Total unique editors

Example: 3

cardCountnumberRequired

Number of cards in the Gamma

Example: 12

lastOpenedstring · nullableRequired

ISO-8601 timestamp of the most recent view, or null if never viewed

Example: 2026-06-28T14:30:00.000Z

400

Invalid request parameters

401

Invalid or missing API key

403

Access denied — at least edit permission required

404

Gamma not found

get/v1.0/gammas/{gammaId}/analytics

HTTPcURLJavaScriptPython

GET /v1.0/gammas/{gammaId}/analytics HTTP/1.1
Host: public-api.gamma.app
X-API-KEY: YOUR_API_KEY
Accept: */*

{
  "scope": "all",
  "gammaId": "abc123xyz",
  "totalViews": 342,
  "uniqueViewers": 128,
  "uniqueEditors": 3,
  "cardCount": 12,
  "lastOpened": "2026-06-28T14:30:00.000Z",
  "dailyViews": {
    "dayCount": 30,
    "timezone": "America/Los_Angeles",
    "days": [
      {
        "date": "2026-06-15",
        "uniqueViewers": 42
      }
    ]
  }
}

Accepts either the API file ID or the doc ID from a gamma.app/docs/... URL. Requires at least edit permission on the Gamma. The response scope field is all when the API key owner has manage permission (metrics cover every viewer) or self when they have edit permission only (metrics cover that user's activity). Metrics are eventually consistent and update about hourly.

Related

• GET /gammas/{gammaId}/analytics/cards for per-card view time and reach
• GET /gammas/{gammaId}/analytics/viewers for per-viewer engagement rows
• GET /gammas/{gammaId} for title, thumbnail, and URL metadata
• Error codes for authentication and permission failures