This document defines each metric shown on the Gamera Quality page and explains how to reproduce them using the Gamera Data API.
All API requests in this document use the base URL https://portal.gamera.app/api/data/v1 and require a Bearer token:
Authorization: Bearer gam_your_api_key_here
The Scorecard endpoint returns pre-calculated quality scores and averages for up to 10 domains in a single request:
GET /api/data/v1/scorecard?domains=example.com&days=7
| Parameter | Required | Values |
|---|---|---|
domains |
Yes | Comma-separated domains (max 10) |
days |
Yes | 1, 7, or 30 |
The response includes a numeric score (0–100), a letter grade, and the site-wide average for every metric described below. If that's all you need, you can stop here.
The rest of this document explains exactly how those numbers are derived, so you can reproduce or extend them from raw data.
Two endpoints provide the underlying data for all quality metrics:
Returns per-placement ad performance data. Used for Refresh Rate, Viewability, Impressions per Session, and CTR.
GET /api/data/v1/{domain}/placements?start_date=2026-04-20&end_date=2026-04-22&order_by=total_imps:desc&limit=10000
Key fields returned per row:
| Field | Description |
|---|---|
device_type |
mobile, desktop, or tablet |
page |
Page path |
placement_id |
Ad unit identifier |
total_imps |
Total impressions for this placement |
total_viewable |
Viewable impressions |
total_clicks |
Click count |
avg_refresh_interval |
Average seconds between ad refreshes |
viewable_rate |
Viewability percentage (0–100) |
avg_imps_per_session |
Average impressions per session for this placement |
ctr |
Click-through rate percentage |
Returns page-level ad health data. Used for Ad Density and Impressions per Minute.