Skip to main content

Creator Metrics

GET 
/campaign/:id/creator/:creatorId/metrics

Returns aggregated engagement metrics for a specific creator within a campaign, including impressions, reactions, comments, reposts, and engagement rate.

The metrics are aggregated from all posts by this creator that are associated with the campaign.

Date Range Filtering​

Optionally filter by date range using startDate and endDate query parameters. When specified, the API returns the metrics snapshot recorded within that date range.

How it works: Metrics are stored as cumulative totals. Each day, a snapshot captures the total impressions, reactions, etc. up to that point. The date filter returns the latest snapshot within your specified range.

Example use cases:

Use CaseRequest
Current metricsGET /campaign/123/creator/456/metrics
Metrics as of end of Q2 2024GET /campaign/123/creator/456/metrics?endDate=2024-06-30
Metrics for a specific periodGET /campaign/123/creator/456/metrics?startDate=2024-01-01&endDate=2024-06-30

Request​

Responses​

Creator metrics retrieved successfully

Response Headers
    X-RateLimit-Limit

    The maximum number of requests allowed per minute

    X-RateLimit-Remaining

    The number of requests remaining in the current window

    X-RateLimit-Reset

    Unix timestamp when the rate limit window resets