CreatorIQ: Most-used fields#
The table below gives information about most-used fields that you can import from CreatorIQ. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
API name |
Adverity UI name |
Description |
Use in Adverity |
|---|---|---|---|
ActualImpressions |
ActualImpressions |
The actual number of times a post was displayed. Note: This field is marked for deprecation in the CreatorIQ API. |
metric |
ActualReach |
ActualReach |
The actual number of unique users who saw the post. Similar to ‘Reach’ which indicates unique accounts that saw the post. |
metric |
Age |
Age |
Demographic data representing the age of the audience or publisher. This is typically retrieved from publisher or audience data. |
metric |
AverageViewDuration |
AverageViewDuration |
The average length of time (in seconds) that viewers watched a video or streamed content. This is a common video performance metric. |
metric |
AverageViewPercentage |
AverageViewPercentage |
metric |
|
AvgStreamConcurrentViews |
AvgStreamConcurrentViews |
metric |
|
CampaignId |
CampaignId |
Unique identifier for a marketing campaign. |
metric |
CampaignName |
CampaignName |
The name given to an influencer marketing campaign. |
dimension |
CampaignStatus |
CampaignStatus |
The current operational status of the marketing campaign. |
dimension |
Clicks |
Clicks |
The total number of clicks on a post, which may include clicks on links, profiles, or other elements. |
metric |
Comments |
Comments |
The total number of comments received on a social media post. |
metric |
Country |
Country |
Demographic data representing the country of the audience or publisher. This is typically retrieved from publisher or audience data. |
dimension |
Dislikes |
Dislikes |
The total number of dislikes received on a piece of content, typically for video platforms like YouTube. |
metric |
EarnedMedia |
EarnedMedia |
metric |
|
EndDate |
EndDate |
The end date of the influencer marketing campaign or a post’s activity period. |
dimension |
Engagement |
Engagement |
A measure of audience interaction with content (e.g., likes, comments, shares). |
metric |
EngagementRate |
EngagementRate |
A metric indicating the level of interaction users have with content, calculated based on various engagement metrics like likes, comments, and shares relative to reach or impressions. |
metric |
EstimatedImpressions |
EstimatedImpressions |
An estimated number of times a post was displayed. This is often an approximation used in campaign planning or reporting. |
metric |
EstimatedImpressionsFlag |
EstimatedImpressionsFlag |
metric |
|
EstimatedReach |
EstimatedReach |
An estimated number of unique users who saw the post. This is often an approximation used in campaign planning or reporting. |
metric |
EstimatedReachFlag |
EstimatedReachFlag |
metric |
|
Exits |
Exits |
metric |
|
FacebookComments |
FacebookComments |
The total number of comments received on a Facebook post. |
dimension |
FacebookLikes |
FacebookLikes |
The total number of likes received on a Facebook post. |
dimension |
FacebookShares |
FacebookShares |
The total number of shares a Facebook post received. |
dimension |
FollowersAtTimeOfPost |
FollowersAtTimeOfPost |
The count of followers a social account had at the specific time a post was published. |
metric |
Follows |
Follows |
The number of new followers gained directly from a post or interaction. |
dimension |
IGCombinedEngagement |
IGCombinedEngagement |
The combined engagement metrics for an Instagram post, which may include various interactions like likes, comments, and shares. |
metric |
IGEngagement |
IGEngagement |
The total engagement for an Instagram post, including interactions like likes and comments. |
metric |
IGPaidEngagement |
IGPaidEngagement |
The engagement generated on Instagram posts through paid promotional efforts. |
dimension |
Id |
Id |
A generic unique identifier for an entity, which could be a post, publisher, or campaign depending on the context. |
dimension |
InstagramShares |
InstagramShares |
The number of times an Instagram post was shared, for example, through direct messages. |
metric |
Likes |
Likes |
The total number of ‘likes’ or positive reactions received on a social media post. |
metric |
LinkClicks |
LinkClicks |
The total number of times a link within the post was clicked by users. |
dimension |
MinutesWatched |
MinutesWatched |
The total duration, in minutes, that users spent watching video content. |
metric |
NetworkImpressions |
NetworkImpressions |
The total number of impressions across the entire social network for a post. Note: This field is marked for deprecation in the CreatorIQ API. |
metric |
NetworkPublisherId |
NetworkPublisherId |
metric |
|
NetworkViews_next |
NetworkViews_next |
The total number of views across the entire social network, using the updated ‘views_next’ metric. This field replaces older ‘Views’ metrics. |
metric |
OneTimeFollowers |
OneTimeFollowers |
metric |
|
OneTimeReach |
OneTimeReach |
metric |
|
PartnerId |
PartnerId |
metric |
|
PeakStreamConcurrentViews |
PeakStreamConcurrentViews |
metric |
|
PinterestShares |
PinterestShares |
The total number of times a Pinterest post (Pin) was shared or re-pinned. |
dimension |
Post |
Post |
A general reference to a social media post, which can include various details and metrics. |
dimension |
PostId |
PostId |
A unique identifier for a specific social media post. |
dimension |
PostKey |
PostKey |
dimension |
|
PostLink |
PostLink |
The URL of the social media post. |
dimension |
PostTitle |
PostTitle |
The title or caption associated with the social media post. |
dimension |
PostType |
PostType |
The type of social media post, e.g., video, image, story. |
dimension |
Posts |
Posts |
The individual pieces of content published by an influencer as part of a campaign. This includes various post types such as photos, videos, or reels, and is a core component of campaign activity data. |
metric |
ProfileVisits |
ProfileVisits |
The number of times users clicked to view the associated profile from the post. |
metric |
PublisherId |
PublisherId |
A unique identifier for the publisher (content creator/influencer). |
metric |
PublisherName |
PublisherName |
The name of the publisher (content creator/influencer). |
dimension |
Reach |
Reach |
The number of unique users who saw the post or content. |
metric |
Replies |
Replies |
The total number of replies or responses to a post, commonly used for conversational platforms like Twitter. |
metric |
Retweets |
Retweets |
The total number of times a Twitter post was retweeted. |
metric |
Saves |
Saves |
The number of times a post was saved or bookmarked by users, common on platforms like Instagram and Pinterest. |
metric |
SocialId |
SocialId |
metric |
|
SocialNetwork |
SocialNetwork |
The social media platform where the post was published (e.g., Instagram, TikTok, YouTube). |
dimension |
SocialNetworkId |
SocialNetworkId |
The identifier for the social network where the post was published, e.g., ‘instagram’, ‘facebook’. |
dimension |
StartDate |
StartDate |
The start date of the influencer marketing campaign or a post’s activity period. |
dimension |
Status |
Status |
dimension |
|
TotalReach |
TotalReach |
The total number of unique users who saw the content across all platforms or a specific campaign. |
metric |
TotalShares |
TotalShares |
The total number of times a piece of content (post) has been shared across social media platforms within a campaign. This is a per-post performance metric. |
metric |
TotalViewTime |
TotalViewTime |
The cumulative duration, in seconds, that users spent watching video content. |
metric |
TwitterShares |
TwitterShares |
The total number of times a Twitter post (Tweet) was shared or retweeted. |
dimension |
UserName |
UserName |
The username of the social media account that published the post. |
dimension |
Views |
Views |
The number of times content was viewed. This field is a metric. |
metric |
ViewsUnique |
ViewsUnique |
The number of unique viewers for a video or content. Note: This field is marked for deprecation in the CreatorIQ API. |
dimension |
Views_next |
Views_next |
The updated and current total number of views for a post or video content. This field replaces older ‘Views’ metrics. |
metric |
Votes |
Votes |
dimension |