---
title: "Analytics"
description: "Fetch cached official analytics for published posts and connected accounts."
section: "API reference"
url: https://dravo.dev/docs/api/analytics
---
# Analytics

Analytics are official platform metrics cached by Dravo. If a cached row is
missing or stale, Dravo refreshes it from the platform API and stores the latest
metrics internally. Use `refresh=true` when you want to bypass fresh cache and
ask the platform again.

Post analytics use the `platform_post_id` saved in publish results, so they only
exist for posts published through Dravo that returned a usable platform id.
Account analytics return the account/profile metrics each platform exposes, such
as followers, reach, views, engagement, public metrics, page statistics and video
profile stats.

## The analytics resource

There are no public snapshot or sync resources. Cache refresh is handled behind
the analytics GET endpoints, and each item returns its own `sync_status`,
`last_updated_at`, `warnings` and `error_message` fields.

Each endpoint lives on its own page:

- [Get post analytics](/docs/api/analytics/posts): `GET /v1/analytics/posts`
- [Get account analytics](/docs/api/analytics/accounts): `GET /v1/analytics/accounts`

New dashboard connections request both `publish` and `analytics` capabilities.
Existing API integrations can keep requesting the default publish scope set, or
pass `capabilities=publish,analytics` to `GET /v1/oauth/{platform}/start` when
they need analytics.

Some metrics depend on platform app review, account type, API tier or the
platform's retention window. Dravo returns the metrics it can fetch and marks an
item as `partial` when some requested metrics were unavailable.