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:
GET /v1/analytics/posts - Get account analytics:
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.