# Metrics

Content metrics and analytics endpoints

## Refresh metrics for a participation's submitted content

 - [POST /metrics/participations/{participationId}/refresh](https://docs-staging.varmply.com/openapi/metrics/refreshparticipationmetrics.md): Refreshes metrics (impressions, reach, likes, comments, saves, shares) for a participation's submitted content.
Fetches the latest metrics from the social media platform API and creates a snapshot.
Requires the participation to have submitted content and the user to have a connected social account with valid OAuth tokens.
Returns 200 OK with the created metrics snapshot on success.

## Refresh metrics for all eligible participations in a campaign

 - [POST /metrics/campaigns/{campaignId}/refresh](https://docs-staging.varmply.com/openapi/metrics/refreshcampaignmetrics.md): Refreshes metrics for all eligible participations in a campaign.
Eligible participations are those with Instagram content submissions and status APPROVED or COMPLETED.
Processes participations sequentially and returns a summary of successful and failed refreshes.
Only the campaign owner can refresh metrics for their campaign.
Returns 200 OK with the refresh summary on success.

## Get campaign analytics summary

 - [GET /analytics/campaigns/{campaignId}/summary](https://docs-staging.varmply.com/openapi/metrics/getcampaignanalyticssummary.md): Returns read-only analytics summary for a campaign, including aggregated metrics totals
and participation-level breakdown. Only the campaign owner can view analytics.
Returns aggregated metrics from the latest snapshot per participation.

## Get campaign payout preview

 - [GET /analytics/campaigns/{campaignId}/payout-preview](https://docs-staging.varmply.com/openapi/metrics/getcampaignpayoutpreview.md): Returns a read-only payout preview for a campaign showing calculated payouts per participation
based on metrics and a default payout formula, compared against available escrow balance.
Only the campaign owner can view payout previews. This endpoint does not execute any payouts.