Influencer Campaign Metrics
This page explains what the Influencer Campaigns metrics mean and which networks each statistic is available for. For request and response schemas, use the generated endpoint reference:
| Endpoint | Reference |
|---|---|
GET /v3/accounts/me/klear/workspaces | List all Klear workspaces |
GET /v3/influencers/tags | List Influencer Tags |
GET /v3/influencers/campaigns | List all Campaigns |
GET /v3/influencers/campaigns/{campaign_id} | Fetch a Campaign |
GET /v3/influencers/campaigns/{campaign_id}/posts | Fetch a Campaign's posts |
GET /v3/influencers/campaigns/{campaign_id}/influencers | Fetch a Campaign's influencers |
To learn how to use these endpoints together, read the Fetching Campaigns & Metrics guide.
Metrics are returned at four levels of aggregation:
| Level | Where it appears |
|---|---|
| Campaign | The metrics object of Fetch a Campaign |
| Campaign, per network | Each entry of the sources object of Fetch a Campaign |
| Post | Each entry of the posts array of Fetch a Campaign's posts |
| Influencer | Each entry of the influencers array of Fetch a Campaign's influencers |
Campaign metrics are updated daily, between 18:00 and 21:00 UTC. All figures on this page are therefore up to 24 hours behind the source networks.
Supported networks
Influencer campaign data is available for the following networks. Use the API name in the sources parameter when fetching posts or influencers.
| Social network | API name |
|---|---|
facebook | |
instagram | |
| Instagram Stories | instagram_stories |
| TikTok | tiktok |
Campaign metrics
High-level metrics for the campaign as a whole, returned in the metrics object.
| Metric | Description |
|---|---|
num_posts | Number of posts created by influencers for the campaign. |
num_influencers | Number of influencers associated with the campaign. |
total_engagement | Total number of engagements across all campaign posts. |
engagement_rate | Average rate of engagement for campaign posts. |
total_reach | Total reach across all campaign posts. |
total_emv | Total EMV (Earned Media Value) across all campaign posts. |
Per-network campaign metrics
The same campaign broken down by social network, returned under each entry of the sources object. These six metrics are returned for every supported network.
| Metric | Description |
|---|---|
num_posts | Number of posts created by influencers for the campaign on this network. |
num_influencers | Number of influencers associated with the campaign on this network. |
engagement | Total engagement for all campaign posts on this network. |
engagement_rate | Average rate of engagement for campaign posts on this network. |
reach | Total reach across all campaign posts on this network. |
emv | Total EMV across all campaign posts on this network. |
Only networks the campaign actually has posts on appear under sources.
Each network entry also carries a stats object holding the raw interaction counts for that network. The same stats fields appear on individual posts, where they describe that single post rather than the network total.
Network statistics
stats is a free-form object in the API schema, so its contents are not described by the endpoint reference. Which fields you get depends on the network:
| Statistic | Instagram Stories | TikTok | ||
|---|---|---|---|---|
comments | Yes | Yes | - | Yes |
likes | Yes | Yes | - | Yes |
impressions | - | Yes | Yes | - |
reach | - | Yes | Yes | - |
saved | - | Yes | - | - |
views | - | Yes | - | Yes |
shares | - | - | - | Yes |
exits | - | - | Yes | - |
replies | - | - | Yes | - |
taps_back | - | - | Yes | - |
taps_forward | - | - | Yes | - |
Definitions:
| Statistic | Description |
|---|---|
comments | Number of comment engagements on a post, or across all posts at campaign or influencer aggregation level. |
likes | Number of like engagements on a post, or across all posts at campaign or influencer aggregation level. |
impressions | Number of times a post has been displayed, or total displays across posts at campaign or influencer aggregation level. |
reach | Reach of the post, or total reach of posts at campaign or influencer aggregation level. This is a distinct measure from the network-level reach metric above. |
saved | Number of save engagements on a post, or across all posts at campaign or influencer aggregation level. |
views | Number of views of a post, or across all posts at campaign or influencer aggregation level. |
shares | Number of shares of a post, or across all posts at campaign or influencer aggregation level. |
exits | Number of exits from a story, or across all stories at campaign or influencer aggregation level. |
replies | Number of reply engagements on a story, or across all stories at campaign or influencer aggregation level. |
taps_back | Number of tap back engagements on a story, or across all stories at campaign or influencer aggregation level. |
taps_forward | Number of tap forward engagements on a story, or across all stories at campaign or influencer aggregation level. |
Post metrics
Each post carries its own performance figures alongside the network stats above. See Fetch a Campaign's posts for the complete response schema.
| Metric | Description |
|---|---|
engagement | Total engagement on the post. |
reach | Reach of the post. |
emv | EMV attributed to the post. |
Use influencer_id to join a post back to the influencer record returned by Fetch a Campaign's influencers.
Influencer campaign metrics
How an influencer performed on this campaign, returned in the campaign_metrics object of each influencer. These figures respect the sources and tags filters applied to the request.
| Metric | Description |
|---|---|
num_posts | Number of posts created by the influencer for the campaign. |
engagement | Total engagement across the influencer's campaign posts. |
engagement_rate | Average rate of engagement across the influencer's campaign posts. |
reach | Total reach across the influencer's campaign posts. |
emv | Total EMV across the influencer's campaign posts. |
sales | Sales attributed to the influencer, as an object keyed by ISO currency code, for example {"USD": 4280}. Only present where sales attribution is available. |
Influencer profile metrics
Klear's assessment of the influencer overall, independent of any campaign, returned in the influencer_metrics object.
| Metric | Description |
|---|---|
influence | The Klear influence score for this influencer. |
brand_score | The brand score for this influencer as provided by the Klear platform. |
true_reach | The influencer's true reach across all their networks. |
followers | Total number of followers across all the influencer's networks. |
Two further fields are returned on the influencer object itself rather than inside influencer_metrics:
| Field | Description |
|---|---|
budget | The budget assigned to this influencer for the campaign. |
tags | The influencer tags applied to this influencer in Klear, each with an id and name. Use the id values with the tags filter on the campaign metrics, posts and influencers endpoints. |
Per-network influencer profile
influencer_metrics.sources breaks the influencer's profile down by network. The same fields are returned for every supported network.
| Field | Description |
|---|---|
id | The network's identifier for the influencer's profile. |
username | The influencer's handle on the network. |
followers | Number of followers the influencer has on this network. |
engagement_per_post | Average number of engagements per post for the influencer on this network. |
true_reach | The influencer's true reach on this network. |
A note on reach
reach appears at several levels and they are not interchangeable, nor additive:
- Campaign
total_reachis not the sum of the per-networkreachfigures. - A network's top-level
reachis a different measure fromstats.reachwithin the same object. - An influencer's
campaign_metrics.reachcovers only their campaign posts, whileinfluencer_metrics.true_reachdescribes their whole audience.
Report each at the level you fetched it rather than deriving one from another.