get_product_analytics
A product’s activity over a date range, per day (or per hour for ranges up to 7 days), in the organization timezone: new installs, activations (incl. reactivations), deactivations, uninstalls (removals — not deactivations), telemetry events received, and for days the active-install snapshot. from/to are YYYY-MM-DD (default last 30 days, max 400). Ranges over 90 days cost 3 rate-limit units.
- Server: Organization server
- Scope:
analytics:read - Read-only: yes
Input
{
"properties": {
"product": {
"description": "The product id (UUID) or slug, as list_products returns them.",
"type": "string"
},
"from": {
"description": "YYYY-MM-DD, default 30 days ago.",
"type": "string"
},
"to": {
"description": "YYYY-MM-DD inclusive, default today.",
"type": "string"
},
"granularity": {
"description": "Default day; hour allows at most 7 days.",
"enum": [
"day",
"hour"
],
"type": "string"
}
},
"type": "object",
"required": [
"product"
]
}Output (structuredContent)
{
"properties": {
"as_of": {
"type": "string"
},
"product_id": {
"type": "string"
},
"range": {
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"timezone": {
"type": "string"
},
"days": {
"type": "integer"
}
},
"type": "object"
},
"granularity": {
"type": "string"
},
"totals": {
"properties": {
"installs_count": {
"type": "integer"
},
"activations_count": {
"type": "integer"
},
"deactivations_count": {
"type": "integer"
},
"uninstalls_count": {
"type": "integer"
},
"telemetry_events_count": {
"type": "integer"
}
},
"type": "object"
},
"series": {
"type": "array"
}
},
"type": "object",
"required": [
"as_of",
"product_id",
"range",
"granularity",
"totals",
"series"
]
}