Skip to content

Domain x provider matrix

GET
/api/v1/analytics/matrix
curl --request GET \
--url https://dashboard.justcrawl.io/api/v1/analytics/matrix \
--header 'Authorization: Bearer <token>'

Domain × provider cross-tab — for each (domain, provider) cell the org has actually used during the window, the request count, success rate, latency, and cost. Powers the dashboard’s heatmap. Org-scoped, cached read. Cells with zero traffic are omitted (the heatmap renders missing cells as empty); empty array when the cache is cold.

Cache coverage: the analytics service currently pre-populates only the hours=24 key (see services/analytics/src/cache-pusher.ts). Other hours values return an empty array — deliberate caching budget decision, not a missing-data signal.

hours
integer

Lookback window in hours (default 24, max 720). Only hours=24 is cache-populated today.

Array of (domain, provider) cells with rollup metrics.

Media type application/json
Array<object>
object
Example generated
[
{}
]

Missing or invalid authentication token

Media type application/json
object
error
string
Example
{
"error": "Missing or invalid authentication token"
}

Insufficient permissions for this operation

Media type application/json
object
error
string
Example
{
"error": "No organization. Complete onboarding first."
}

Unexpected server error. Logs and PostHog $exception capture

Media type application/json
object
error
string
Example
{
"error": "Something went wrong"
}