Object

CompetitorBrandItem

A single post belonging to a Competitor Insights brand. Posts for a given month become available on day 9 of the following month.

Fields

Object, input and enum types open in place — use + to reveal their fields. A type that is already open above the row stops at a ↻ circular marker, and anything nested past the depth limit links out to its own page instead.

archivePublicUrl String: Stable Archive permalink for this post. Unlike originalUrl, this URL keeps resolving after the source post is deleted on the originating platform. Mirrors Item.archivePublicUrl for parity.
caption String: Caption text of the post, when available. Mirrors Item.caption for parity.
currentEngagement Engagement: Most recent engagement metrics (likes, comments, impressions, shares, EMV) and virality score for this post. Read impressions for views, plays, or reach.
comments BigInt: Total number of comments.
earnedMediaValue BigInt: Estimated earned media value (EMV) in cents.
impressions BigInt: Number of views, plays, or estimated impressions. Use this field for a post's views, plays, or reach. Archive estimates it for Instagram stories. For other posts it holds the larger of the platform's view and play counts. Archive estimates it for an Instagram post that has neither count. Null when Archive has no count for the post.
likes BigInt: Total number of likes.
linearViralityScore ViralityScore!: Bucketed virality score.
HIGH: Content that significantly outperforms its expected reach. Typically corresponds to a view-to-follower ratio of 4.0 or higher.
LOW: Content performing close to expected baseline relative to audience size. Typically corresponds to a view-to-follower ratio between ~1.0 and 2.0.
MEDIUM: Content performing above average relative to audience size. Typically corresponds to a view-to-follower ratio between ~2.0 and 4.0.
NOT_VIRAL: Content performing below expected reach, with low relative visibility. Typically corresponds to a view-to-follower ratio below ~1.0.
shares BigInt: Number of shares.
views BigInt: View count as reported by the platform, kept separate from plays. Rarely populated: null for most items. Use impressions for views, plays, or reach.
externalId ID!: Platform-side identifier (Instagram media id, TikTok video id, etc.).
hashtags [String!]: List of hashtags used in the post. Mirrors Item.hashtags for parity.
id ID!: Unique identifier of the underlying media item in Archive's system.
mentions [String!]: List of @-mentions used in the post. Mirrors Item.mentions for parity.
originalUrl String: Direct URL to the post on the source platform. Null for content types without a public URL (e.g. Instagram Stories).
provider Provider!: Platform the post was published on.
INSTAGRAM: Instagram platform integration, including posts, reels, stories, and profile data.
INTERNAL: Internal Archive-managed source used for synthetic or system-generated content.
TIKTOK: TikTok platform integration, including videos and creator profile data.
YOUTUBE: YouTube platform integration, including Shorts, videos, thumbnails, and profile data.
socialProfile SocialProfile!: Social media profile that posted this content.
accountName String!: Username or handle of the social media account.
accountType SocialProfileCategory: Kind of account, as enrichment classifies it. This is the "Profile type" in the Archive app. Returns null when the profile has not been classified.
BRAND: A company or product brand.
CREATOR: An individual who publishes their own content.
MEDIA: A news outlet, magazine or content aggregator that curates or features others' content.
PRO_SERVICE: An individual professional offering services, such as a realtor, trainer, photographer or coach.
PUBLIC_SECTOR: A government body, non-profit, school or public institution.
UNKNOWN: Enrichment ran but could not classify the account.
VENUE: A physical location, such as a restaurant, hotel, store or event space.
avatar String: URL of the account's profile picture, if available.
biography String: Biography text shown on the profile. Returns null when Archive has none.
creator Creator: Creator associated with this social profile in the current workspace. Use this to get the unified creator ID for deduplicating creators across platforms. Returns null if the profile has no creator record in this workspace.
activity ActivityLogEntry paginated: The creator's activity history, newest first: field changes, label edits and linked or unlinked social profiles. The same history the creator drawer shows in the app. Page one creator at a time with creator(id:): an after cursor applies to every creator in the response.
action ActivityLogAction!: What kind of change the entry records.
ADD: A value was added to a list.
CREATE: The creator was created.
CREATE_RELATION: A social profile was linked to the creator.
DELETE: A value was deleted.
REMOVE: A value was removed from a list.
REMOVE_RELATION: A social profile was unlinked from the creator.
UPDATE: A creator field changed, such as a custom attribute.
actorName String: Display name of the workspace member who made the change. Null when no member is recorded or the member has no name.
actorType ActivityLogActorType!: Whether a workspace member or Archive made the change.
SYSTEM: Archive itself, such as an import or an automation.
USER: A workspace member, in the app or through the API.
field String: The changed field, such as custom_attributes.labels or influencers (linked social profiles). Null when the entry is about the creator as a whole.
id ID!: Unique identifier of the entry.
newValue JSON: The value after the change. Null when the change cleared the field.
occurredAt DateTimeWithZone!: When the change happened.
oldValue JSON: The value before the change. Null when the field had no value.
summary String!: A short human-readable line, such as "Updated Relationship Status".
avatar String: URL of the profile picture of the creator's earliest-linked social profile; null when there is none.
campaignIds [ID!]!: Ids of the campaigns this creator is on, limited to the campaigns campaigns lists, newest campaign first. Pass one to campaign(id:). Empty when the creator is on none.
createdAt DateTime!: When the creator was added to the workspace (UTC). creators lists newest first by this value.
customAttributes JSON!: Custom metadata fields associated with the creator (for example CRM attributes).
displayName String: Name to show for the creator: the full_name custom attribute, else the handle of the creator's earliest-linked social profile. Null when neither is set.
id ID!: Unique identifier for the creator in Archive's system.
location CreatorLocation: Canonical location Archive resolved for the creator, the value the locations filter of creators matches. Null when no country has been resolved.
city String: Canonical city (for example "Portland"); null when not resolved.
country String!: Canonical country name (for example "United States").
region String: Canonical region, state or province (for example "Oregon"); null when not resolved.
socialProfiles [SocialProfile!]! ↻ circular view SocialProfile →: Social media profiles linked to this creator across all platforms (for example Instagram, TikTok, YouTube). Returns an empty list if no profiles are linked.
email String: Email address associated with the account, if available.
followers Int!: Number of followers on the social media account (when available).
following Int!: Number of accounts this profile is following (when available).
fullName String: Display name or full name shown on the social media profile.
id ID!: Unique identifier of the social profile in Archive's system.
location Location: Where the account holder is based, resolved to canonical names. The values match the LocationCanonicalInput filters, with state holding the region. name is always null. Returns null when no location is resolved.
city String: City associated with the location.
country String: Country associated with the location.
formatted String: Human-readable formatted address.
name String: Full name of the location.
state String: State, region, or province associated with the location.
originalUrl String!: Direct URL to the profile on the social platform (e.g., https://instagram.com/account_name).
phoneNumbers [String!]: Phone numbers associated with the account, when present.
private Boolean!: Whether the social media account is currently set to private.
proAccount Boolean!: Whether the account is marked as a professional or business account on the platform.
provider Provider!: Platform where the social profile exists (for example INSTAGRAM, TIKTOK, YOUTUBE, or INTERNAL).
INSTAGRAM: Instagram platform integration, including posts, reels, stories, and profile data.
INTERNAL: Internal Archive-managed source used for synthetic or system-generated content.
TIKTOK: TikTok platform integration, including videos and creator profile data.
YOUTUBE: YouTube platform integration, including Shorts, videos, thumbnails, and profile data.
stats SocialProfileStats: Content counts and last-month engagement stats, as the Archive app shows them. Returns null when Archive holds no content for the profile.
engagementsComments BigInt!: Total comments over the last month.
engagementsCommentsAvg Float!: Average comments per item over the last month, rounded to a whole number.
engagementsEmv BigInt!: Total estimated earned media value (EMV) over the last month, in cents.
engagementsEmvAvg Float!: Average estimated earned media value per item over the last month, in cents.
engagementsEmvRate Float!: Average earned media value divided by followers over the last month.
engagementsImpressions BigInt!: Total impressions (views, plays, or estimated impressions) over the last month, across all posts. Use this field for views, plays, or reach.
engagementsImpressionsAvg Float!: Average impressions per item over the last month, rounded to a whole number. Covers every post with an impressions count, including posts with no likes. Use this field for views, plays, or reach.
engagementsImpressionsRate Float!: Average impressions divided by followers over the last month.
engagementsLikes BigInt!: Total likes over the last month.
engagementsLikesAvg Float!: Average likes per item over the last month, rounded to a whole number.
engagementsShares BigInt!: Total shares over the last month.
engagementsSharesAvg Float!: Average shares per item over the last month, rounded to a whole number.
engagementsTotal BigInt!: Total engagements over the last month.
engagementsTotalAvg Float!: Average engagements per item over the last month, rounded to a whole number.
engagementsTotalRate Float!: Average engagement rate (engagements divided by followers) of posts, reels and videos over the last month. A fraction, so 0.05 means 5%.
engagementsViews BigInt!: Total views as reported by the platform over the last month, kept separate from plays. Counts only posts with at least one like. Rarely populated: 0 for most profiles. Use engagementsImpressions for views, plays, or reach.
engagementsViewsAvg Float!: Average platform-reported views per item over the last month, rounded to a whole number. Averages only posts with at least one like and a reported view count. Rarely populated: 0 for most profiles. Use engagementsImpressionsAvg for views, plays, or reach.
itemsCount BigInt!: Number of content items Archive holds for the profile.
itemsIgCount BigInt!: Number of Instagram items.
itemsIgPostsCount BigInt!: Number of Instagram posts.
itemsIgReelsCount BigInt!: Number of Instagram reels.
itemsIgStoriesCount BigInt!: Number of Instagram stories.
itemsTtCount BigInt!: Number of TikTok items.
itemsTtPostsCount BigInt!: Number of TikTok posts.
itemsYtCount BigInt!: Number of YouTube items.
itemsYtPostsCount BigInt!: Number of YouTube videos.
itemsYtShortsCount BigInt!: Number of YouTube Shorts.
verified Boolean!: Whether the account has a verified/badge status on the platform.
takenAt DateTime!: When the post was published on the source platform.
transcriptions [Transcription!]!: Text transcriptions and subtitles generated for video content in this post. Mirrors Item.transcriptions for parity.
mediaContentId ID!: Identifier of the media content this transcription belongs to.
transcript String: Plain text transcription of the spoken content.
type ItemType!: Type of post (post / reel / story / short). Mirrors Item.type for parity.
POST: Standard feed post, such as a single image or carousel post on Instagram.
REEL: Short-form vertical video published as a Reel or equivalent format.
SHORT: Short-form vertical video such as a YouTube Short or similar format.
STORY: Ephemeral story content, typically available for a limited time.