Query
items
Search and paginate archived items (social content) for the current workspace. Order results with the sorting argument, for example by engagement or earned media value: items(sorting: [{sortKey: EARNED_MEDIA_VALUE, sortOrder: DESC}]). Narrow by engagement ranges with filter.engagement.
Arguments
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.
- after String
- Cursor for fetching the next page of results.
- customAttributeConditions [CustomAttributeConditionInput!] default []
- Custom attribute filter conditions.
- field String! required
- Key of the custom attribute to filter on, as returned by customAttributeSchemas (e.g. "sentiment").
- operator FilterOperator! required
- Comparison operator. The valid set depends on the attribute type; see FilterOperator.
- BETWEEN
- Inclusive range match for number and date types; value is { from, to }.
- CONTAINS
- For text-like types: substring match. For multi-select and list types: matches records containing ANY of the provided values (OR semantics).
- CONTAINS_ALL
- For multi-select custom attributes: matches records whose value array contains ALL of the provided values (AND semantics).
- DOES_NOT_CONTAIN
- For text-like types: excludes substring matches. For multi-select and list types: excludes records containing any of the provided values.
- ENDS_WITH
- Suffix match, for text-like types.
- EQUAL
- Equality, for number and date types.
- IS
- Exact match. For text and single-select types (for selects, value is the option ID) and BOOLEAN (value is true/false).
- IS_EMPTY
- Matches records with no value set. Value is ignored; pass null.
- IS_NOT
- Exact non-match, for text and single-select types.
- IS_NOT_EMPTY
- Matches records with any value set. Value is ignored; pass null.
- IS_RELATIVE_TO_TODAY
- Matches date values in a period relative to today; value is { relation: "past"|"this"|"next", period: "day"|"week"|"month"|"year" } (offset optional: a whole number of periods, at most 100 years; tz optional: an IANA time zone).
- LESS_THAN
- Strictly less than, for number and date types.
- LESS_THAN_OR_EQUAL
- Less than or equal, for number and date types.
- MORE_THAN
- Strictly greater than, for number and date types.
- MORE_THAN_OR_EQUAL
- Greater than or equal, for number and date types.
- NOT_EQUAL
- Inequality, for number and date types.
- STARTS_WITH
- Prefix match, for text-like types.
- type CustomAttributeType! required
- Type of the custom attribute, as returned by customAttributeSchemas. Determines the expected value shape and the valid operators.
- BOOLEAN
- True/false value.
- BOOLEAN_LIST
- List of true/false values.
- DATE
- Calendar date value (ISO 8601, no time component).
- DATETIME
- Date-and-time value (ISO 8601).
- DATETIME_LIST
- List of date-and-time values (ISO 8601).
- DATE_LIST
- List of calendar date values (ISO 8601, no time component).
- Email address value.
- MULTIPLE_SELECT
- Multiple choices from a predefined option list; the stored value is an array of option IDs.
- MULTIPLE_SELECT_V2
- Multiple choices from a predefined option list; the stored value is an array of option IDs. Successor revision of MULTIPLE_SELECT with identical filtering behavior.
- NUMBER
- Numeric value.
- NUMBER_LIST
- List of numeric values.
- PHONE
- Phone number value.
- SHIPPING_ADDRESS
- Structured shipping address. Not filterable: conditions with this type are rejected with a validation error; read the value from the record's customAttributes instead.
- SINGLE_SELECT_V2
- Single choice from a predefined option list; the stored value is an option ID.
- SINGLE_SELECT_V3
- Single choice from a predefined option list; the stored value is an option ID. Successor revision of SINGLE_SELECT_V2 with identical filtering behavior.
- TEXT
- Free-form text value.
- TEXT_LIST
- List of free-form text values.
- URL
- URL value.
- value JSON
- Comparison value; the shape depends on type: a string for text-like types, an option ID for single-selects, a number for NUMBER, an ISO 8601 string for dates, true/false for BOOLEAN, an array for multi-select and list types. BETWEEN takes { from, to }. Pass null for IS_EMPTY / IS_NOT_EMPTY.
- filter ItemFilterInput default {}
- Filter criteria to narrow down results.
- accountNames [String!] default []
- Filter by social profile account names/handles.
- brandRelatedOnly Boolean
- When true, apply the workspace's brand-related-content setting exactly as the app's Content page does (product-detection or campaign membership); has no effect when the workspace setting is off. Omitted, null or false leaves results unscoped.
- campaignsIds [ID!] default []
- Filter to items associated with any of the given campaign IDs.
- collectionsIds [ID!] default []
- Filter to items that belong to any of the given collection IDs in the current workspace. Pass the IDs the
collectionsquery returns; the ID values inItem.customAttributes.collectionsare accepted too. An empty list (the default) applies no collection filter, like every other list filter here; an ID that names no collection matches no items. - contentTypes [MediaContentType!]
- Filter by media content type (IMAGE, VIDEO).
- IMAGE
- Static image content (for example photos, thumbnails, frames).
- VIDEO
- Video content (for example Reels, TikToks, Stories, YouTube videos).
- creatorIds [ID!] default []
- Filter to items authored by any of the given creator IDs (the
idthecreatorsquery returns; maximum 1000). An empty list (the default) applies no creator filter. - creatorLocations [LocationCanonicalInput!]
- Filter by the creator's location. Format: an array of objects, each with optional
country,region,city(canonical names from Archive's Geo normalization pipeline; case-sensitive exact match, e.g. "United States", "California", "Los Angeles"). Within a single entry, populated components are AND-ed together. Multiple entries OR together, which is useful for disambiguating same-named cities (e.g. Portland, Oregon vs. Portland, Maine). Omit a component to leave it unconstrained. Example:[{ country: "United States", region: "California" }, { city: "London" }]matches creators in California, USA OR in any city named "London". - city String
- Canonical city name (e.g. "Portland"). Matches creator.city_canonical exactly.
- country String
- Canonical country name (e.g. "United States"). Matches creator.country_canonical exactly.
- group String
- Region group code from
locationGroups(e.g. "european_union", "dach"). The entry matches every member country of the group and country/region/city are ignored in it; an unknown code matches nothing. - region String
- Canonical region/state name (e.g. "Oregon"). Matches creator.region_canonical exactly.
- engagement [FilterEngagementRangeInput!]
- Filter by engagement metric ranges (likes, comments, views, etc.).
- field FilterEngagementField! required
- Engagement metric to filter on.
- COMMENT_COUNT
- Total number of comments.
- EARNED_MEDIA_VALUE
- Estimated earned media value (EMV) in cents.
- ENGAGEMENTS_RATE
- Engagement rate: total engagements divided by the creator's follower count. Bounds are whole percent (5 = 5%); values below 1% are not expressible.
- IMPRESSIONS_RATE
- Impressions rate: views, plays, or estimated impressions divided by the creator's follower count. Bounds are whole percent (5 = 5%); values below 1% are not expressible.
- LIKE_COUNT
- Total number of likes.
- MERGED_VIEW_PLAY_COUNT
- Number of views, plays, or estimated impressions.
- SHARE_COUNT
- Total number of shares.
- range FilterIntegerRangeInput! required
- Inclusive numeric range the metric value must fall within.
- from Int
- Inclusive lower bound. Omit for no lower bound.
- to Int
- Inclusive upper bound. Omit for no upper bound.
- excludeCollectionsIds [ID!] default []
- Drop items that belong to any of the given collection IDs in the current workspace. Accepts the same IDs as
collectionsIdsand combines with it (AND): pass both to keep items in one collection but not another. An empty list (the default) excludes nothing; an ID that names no collection excludes no items. - followersCount FilterIntegerRangeInput
- Filter by social profile follower count range.
- from Int
- Inclusive lower bound. Omit for no lower bound.
- to Int
- Inclusive upper bound. Omit for no upper bound.
- ids [ID!] default []
- Filter to specific item IDs (maximum 1000).
- importType FilterImportType
- Filter by how the item was imported (manual or automatic).
- AUTOMATIC
- Item was captured automatically (e.g. by social listening).
- MANUAL
- Item was imported on request by a user.
- instagramWhitelistingStatus [FilterContractStatus!]
- Filter by Instagram whitelisting request status.
- APPROVED
- Contract has been approved by the creator.
- EXPIRED
- Contract approval has expired.
- IN_QUEUE
- Contract request is queued for processing.
- REJECTED
- Contract request was rejected by the creator.
- REQUESTED
- Contract has been requested but not yet responded to.
- itemTypes [FilterItemType!]
- Filter by item type (POST, REEL, STORY, TIKTOK, TIKTOK_STORY, YOUTUBE, YOUTUBE_SHORT). Each value names a platform and a format together, unlike
Item.type: a TikTok post readstype: POSTbut matchesTIKTOKhere, andPOSTmatches Instagram feed posts only. - POST
- Instagram feed post.
- REEL
- Instagram Reel.
- STORY
- Instagram Story.
- TIKTOK
- TikTok video post.
- TIKTOK_STORY
- TikTok Story.
- YOUTUBE
- YouTube video.
- YOUTUBE_SHORT
- YouTube Short.
- provider Provider
- Filter by source platform (INSTAGRAM, TIKTOK, YOUTUBE, INTERNAL).
- 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.
- shopifyProductsIds [String!] default []
- Filter by associated Shopify product IDs.
- socialProfileAccountTypes [SocialProfileAccountType!] default []
- Filter by the social profile's account type. Values currently reflect Instagram-only typing (Personal / Creator / Business); profiles on platforms without a comparable concept are excluded when this filter is supplied. Mirrors
Influencer.account_type. OR semantics across multiple values; empty/omitted skips the filter. - BUSINESS
- Instagram Business account (business features and insights enabled).
- CREATOR
- Instagram Creator account (creator features enabled, distinct from Business).
- PERSONAL
- Personal Instagram account (consumer profile, no business/creator features).
- socialProfileIds [ID!] default []
- Filter by social profile IDs.
- sourcesIds [ID!] default []
- Filter by source IDs.
- sourcesIdsOperator FilterOperator
- How
sourcesIdsmatches. Accepted values: CONTAINS, CONTAINS_ALL, DOES_NOT_CONTAIN, IS_EMPTY, IS_NOT_EMPTY; any other FilterOperator is refused withINVALID_INPUT. Omitted means CONTAINS (any of the listed values). CONTAINS_ALL requires every listed value; DOES_NOT_CONTAIN drops items carrying any listed value; IS_EMPTY / IS_NOT_EMPTY match items with no / at least one value and ignore the list. CONTAINS, CONTAINS_ALL and DOES_NOT_CONTAIN with an empty list apply no filter. - BETWEEN
- Inclusive range match for number and date types; value is { from, to }.
- CONTAINS
- For text-like types: substring match. For multi-select and list types: matches records containing ANY of the provided values (OR semantics).
- CONTAINS_ALL
- For multi-select custom attributes: matches records whose value array contains ALL of the provided values (AND semantics).
- DOES_NOT_CONTAIN
- For text-like types: excludes substring matches. For multi-select and list types: excludes records containing any of the provided values.
- ENDS_WITH
- Suffix match, for text-like types.
- EQUAL
- Equality, for number and date types.
- IS
- Exact match. For text and single-select types (for selects, value is the option ID) and BOOLEAN (value is true/false).
- IS_EMPTY
- Matches records with no value set. Value is ignored; pass null.
- IS_NOT
- Exact non-match, for text and single-select types.
- IS_NOT_EMPTY
- Matches records with any value set. Value is ignored; pass null.
- IS_RELATIVE_TO_TODAY
- Matches date values in a period relative to today; value is { relation: "past"|"this"|"next", period: "day"|"week"|"month"|"year" } (offset optional: a whole number of periods, at most 100 years; tz optional: an IANA time zone).
- LESS_THAN
- Strictly less than, for number and date types.
- LESS_THAN_OR_EQUAL
- Less than or equal, for number and date types.
- MORE_THAN
- Strictly greater than, for number and date types.
- MORE_THAN_OR_EQUAL
- Greater than or equal, for number and date types.
- NOT_EQUAL
- Inequality, for number and date types.
- STARTS_WITH
- Prefix match, for text-like types.
- superSearch FilterSuperSearchInput
- Visual or semantic search parameters.
- fileName String deprecated
- Ignored: no search reads it, so it has no effect on results. Has no effect. For visual similarity search use
imageUrlorsimilarMediaContentId. - imageUrl String
- URL of an external image to use for visual similarity search. Must be a public http(s) URL; private or local hosts, a malformed URL, or an image that cannot be downloaded return an
INVALID_INPUTerror. - mode FilterSuperSearchMode
- Search mode determining how the query is processed. Defaults to EMBEDDING_CONTENT when omitted. The FUZZY modes search text only, so they need searchQuery.
- EMBEDDING_CONTENT
- Search by visual/semantic similarity using content embeddings.
- FUZZY_CAPTION
- Search by fuzzy matching against post captions.
- FUZZY_TRANSCRIPTION
- Search by fuzzy matching against video/audio transcriptions.
- searchQuery String
- Text query to search captions, transcriptions, or semantic content. A blank value is no search query. The text is matched as written (semantic similarity for
EMBEDDING_CONTENT, fuzzy text match forFUZZY_CAPTION/FUZZY_TRANSCRIPTION); it is never turned into structured filters the way the Archive app's natural-language search can be. To narrow by hashtags, handles, dates, platform or engagement, settagsNames,accountNames,takenAt,provider/itemTypesorengagementon the filter yourself. - similarMediaContentId ID
- ID of a media content to find visually similar items (the numeric
MediaContent.id). Any other value returns anINVALID_INPUTerror. - tagsNames [String!] default []
- Filter by hashtag or mention tag names (maximum 100).
- tagsNamesOperator FilterOperator
- How
tagsNamesmatches. Accepted values: CONTAINS, CONTAINS_ALL, DOES_NOT_CONTAIN, IS_EMPTY, IS_NOT_EMPTY; any other FilterOperator is refused withINVALID_INPUT. Omitted means CONTAINS (any of the listed values). CONTAINS_ALL requires every listed value; DOES_NOT_CONTAIN drops items carrying any listed value; IS_EMPTY / IS_NOT_EMPTY match items with no / at least one value and ignore the list. CONTAINS, CONTAINS_ALL and DOES_NOT_CONTAIN with an empty list apply no filter. A name that matches no tag in the workspace is ignored by DOES_NOT_CONTAIN. - BETWEEN
- Inclusive range match for number and date types; value is { from, to }.
- CONTAINS
- For text-like types: substring match. For multi-select and list types: matches records containing ANY of the provided values (OR semantics).
- CONTAINS_ALL
- For multi-select custom attributes: matches records whose value array contains ALL of the provided values (AND semantics).
- DOES_NOT_CONTAIN
- For text-like types: excludes substring matches. For multi-select and list types: excludes records containing any of the provided values.
- ENDS_WITH
- Suffix match, for text-like types.
- EQUAL
- Equality, for number and date types.
- IS
- Exact match. For text and single-select types (for selects, value is the option ID) and BOOLEAN (value is true/false).
- IS_EMPTY
- Matches records with no value set. Value is ignored; pass null.
- IS_NOT
- Exact non-match, for text and single-select types.
- IS_NOT_EMPTY
- Matches records with any value set. Value is ignored; pass null.
- IS_RELATIVE_TO_TODAY
- Matches date values in a period relative to today; value is { relation: "past"|"this"|"next", period: "day"|"week"|"month"|"year" } (offset optional: a whole number of periods, at most 100 years; tz optional: an IANA time zone).
- LESS_THAN
- Strictly less than, for number and date types.
- LESS_THAN_OR_EQUAL
- Less than or equal, for number and date types.
- MORE_THAN
- Strictly greater than, for number and date types.
- MORE_THAN_OR_EQUAL
- Greater than or equal, for number and date types.
- NOT_EQUAL
- Inequality, for number and date types.
- STARTS_WITH
- Prefix match, for text-like types.
- takenAt FilterDateRangeInput
- Filter by publication date range.
- from DateTime
- Inclusive lower bound (ISO 8601). Omit for no lower bound.
- to DateTime
- Inclusive upper bound (ISO 8601). Omit for no upper bound.
- tiktokSparkCodeStatus [FilterContractStatus!]
- Filter by TikTok Spark Code request status.
- APPROVED
- Contract has been approved by the creator.
- EXPIRED
- Contract approval has expired.
- IN_QUEUE
- Contract request is queued for processing.
- REJECTED
- Contract request was rejected by the creator.
- REQUESTED
- Contract has been requested but not yet responded to.
- tiktokWhitelistingEligibility FilterTikTokWhitelistingEligibility
- Filter to items authored by TikTok creators eligible for whitelisting.
- ALL
- Match items authored by TikTok creators reachable via manual DM for whitelisting.
- ugcLocations [LocationCanonicalInput!]
- Filter by the location tagged on the content itself (UGC location). Format: same as
creatorLocations: an array of objects with optionalcountry,region,city(canonical, case-sensitive exact match). Within a single entry the populated components AND together; multiple entries OR together. Example:[{ country: "United Kingdom", city: "London" }]matches items whose tagged location resolves to London, UK. - city String
- Canonical city name (e.g. "Portland"). Matches creator.city_canonical exactly.
- country String
- Canonical country name (e.g. "United States"). Matches creator.country_canonical exactly.
- group String
- Region group code from
locationGroups(e.g. "european_union", "dach"). The entry matches every member country of the group and country/region/city are ignored in it; an unknown code matches nothing. - region String
- Canonical region/state name (e.g. "Oregon"). Matches creator.region_canonical exactly.
- usageRightsStatus [FilterContractStatus!]
- Filter by usage rights request status.
- APPROVED
- Contract has been approved by the creator.
- EXPIRED
- Contract approval has expired.
- IN_QUEUE
- Contract request is queued for processing.
- REJECTED
- Contract request was rejected by the creator.
- REQUESTED
- Contract has been requested but not yet responded to.
- verified [Boolean!]
- Filter by social profile verification status.
- viralityScore [FilterViralityScore!] default []
- Filter by virality score categories.
- 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.
- first Int default 20
- Number of items to return (page size).
- presetId ID
- Filter preset ID. When provided, sorting, filter, and customAttributeConditions are ignored. Must reference a preset with accessor
media_deckorcollections; pass IDs returned bycontentViews/collectionsqueries. Unknown, cross-workspace, or wrong-accessor preset IDs raise a GraphQL error withextensions.code = "WRONG_VIEW_TYPE_FOR_ITEMS". - sorting [ItemSortingInput!] default [{sortKey: TAKEN_AT, sortOrder: DESC}]
- Sorting instructions to apply to the result set. Defaults to TAKEN_AT DESC. Sort by engagement or earned media value with an
ItemSortKey, for examplesorting: [{sortKey: EARNED_MEDIA_VALUE, sortOrder: DESC}]orLIKE_COUNT. To limit results to an engagement range, usefilter.engagement. - sortKey ItemSortKey! required
- Which field to sort items by.
- ACCOUNT_NAME
- Sort by creator account name.
- COMMENT_COUNT
- Sort by total number of comments.
- EARNED_MEDIA_VALUE
- Sort by earned media value (EMV).
- EXPONENTIAL_VIRALITY
- Sort by exponential virality score.
- FOLLOWERS_COUNT
- Sort by number of followers on the posting account.
- LIKE_COUNT
- Sort by total number of likes.
- LINEAR_VIRALITY
- Sort by linear virality score.
- MERGED_VIEW_PLAY_COUNT
- Sort by the combined view/play count across platforms.
- RESOLVED_VIRALITY
- Sort by the virality score the Archive app shows and sorts by.
- SHARE_COUNT
- Sort by number of shares.
- TAKEN_AT
- Sort by when the content was originally posted on the social platform.
- sortOrder SortOrder! required
- Whether to sort ascending (ASC) or descending (DESC).
- ASC
- Sort in ascending order (for example oldest date or smallest number first).
- DESC
- Sort in descending order (for example newest date or largest number first).
Returns
A paginated connection of Item nodes. See Pagination for the connection shape.
- edges [ItemEdge!]!
- List of edges with cursors.
- cursor String!
- Cursor for this node.
- node Item!
- The item.
- aiFilterReasons [AiFilterReason!]!
- Explanations the AI Filters produced for this item's AI-generated custom attributes, one entry per AI-generated attribute the item has. Pair each entry to its value by
keyincustomAttributes;customAttributeSchemasmarks which keys are AI-generated viaaiGenerated. Empty when the item has none. - key String!
- Custom-attribute key this explanation belongs to. Matches a key in
customAttributesand thekeyof acustomAttributeSchemasentry. - reason String
- The AI Filter's explanation for the value it assigned. Null when the run recorded no explanation; an empty string is returned verbatim when the model produced one.
- archivePublicUrl String
- Stable Archive permalink for this item. Unlike
originalUrl, this URL keeps resolving after the source post is deleted or the creator account goes private. - caption String
- Caption text of the content, when available.
- coAuthors [SocialProfile!]!
- Other social profiles credited as co-authors of a collaborative post, excluding
socialProfileitself. Empty for a single-author post. - 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:): anaftercursor applies to every creator in the response. - action ActivityLogAction! Continue in ActivityLogAction →
- What kind of change the entry records.
- 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! Continue in ActivityLogActorType →
- Whether a workspace member or Archive made the change.
- field String
- The changed field, such as
custom_attributes.labelsorinfluencers(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
campaignslists, newest campaign first. Pass one tocampaign(id:). Empty when the creator is on none. - createdAt DateTime!
- When the creator was added to the workspace (UTC).
creatorslists 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_namecustom 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
locationsfilter ofcreatorsmatches. 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
LocationCanonicalInputfilters, withstateholding the region.nameis 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 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
engagementsImpressionsfor 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
engagementsImpressionsAvgfor 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.
- createdAt DateTime!
- Timestamp when Archive ingested the item into this workspace (UTC). Compare
takenAt, the publication time on the platform. - creator Creator!
- Creator who posted this content.
- 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:): anaftercursor 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.labelsorinfluencers(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
campaignslists, newest campaign first. Pass one tocampaign(id:). Empty when the creator is on none. - createdAt DateTime!
- When the creator was added to the workspace (UTC).
creatorslists 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_namecustom 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
locationsfilter ofcreatorsmatches. 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!]!
- Social media profiles linked to this creator across all platforms (for example Instagram, TikTok, YouTube). Returns an empty list if no profiles are linked.
- 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 ↻ circular view 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.
- 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
LocationCanonicalInputfilters, withstateholding the region.nameis 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 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
engagementsImpressionsfor 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
engagementsImpressionsAvgfor 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.
- currentEngagement Engagement
- Most recent engagement metrics (likes, comments, impressions, shares, EMV) and virality score for this item. Read
impressionsfor 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
impressionsfor views, plays, or reach. - customAttributes JSON!
- Custom metadata fields associated with the item.
- customProduct ItemCustomProduct
- The custom product (a link with a call to action) attached to this item. Null when none is attached.
- action String
- Call-to-action label shown with the link (for example "Buy now").
- id ID!
- Unique identifier of the custom product in Archive.
- title String!
- Product title. May be empty.
- url String
- Link the custom product points to.
- detectedPaidPartnership Boolean!
- Whether Archive's AI classifier detected a paid partnership (sponsored, affiliate, collab or gifted content) on this item. Reflects AI detection only: a native platform paid-partnership disclosure on its own does not make this true. See
detectedPaidPartnershipDetailsfor the classifier's reasoning. - detectedPaidPartnershipDetails DetectedPaidPartnershipDetails
- The AI classifier's detection details for this item. Null when
detectedPaidPartnershipis false. - partnershipType String
- Kind of partnership the classifier detected:
sponsored,affiliate,collaborgifted. Returned as a plain string so new kinds can appear without a schema change; treat an unrecognized value as a generic paid partnership. Null when the classifier recorded no type. - reasoning String
- The classifier's one-sentence explanation of why it detected a paid partnership, returned verbatim. Null when the classifier recorded no explanation.
- externalId ID!
- Platform-specific identifier for the content (e.g., Instagram post ID, TikTok video ID).
- hashtags [String!]
- List of hashtags used in the item’s caption or metadata.
- id ID!
- Unique identifier for the item in Archive's system.
- location Location
- Location associated with the content, if present.
- 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.
- mediaItemId ID!
- Identifier of the parent media item. Use this to group related contents (e.g., carousel frames) that belong to the same post.
- mentions [String!]
- List of user mentions used in the item’s caption or metadata.
- originalUrl String
- Direct URL to the original content on the social platform. Returns null for content types without public URLs (e.g., Instagram Stories).
- products ItemProduct paginated
- Products from the workspace's Shopify catalog linked to this item, by a person or by Archive's product detection, ordered by product ID. Paginated with
first(default 20, maximum 100) andafter;totalCountis computed only when selected. Empty when none is linked. - externalId ID
- Shopify product ID, when known.
- handle String
- Shopify product handle (the URL slug of the product page), when known.
- id ID!
- Unique identifier of the product in Archive. Pass it to
ItemFilterInput.shopifyProductsIdsto find other items linked to the same product. - title String!
- Product title.
- provider Provider!
- Platform where the content exists (for example INSTAGRAM, TIKTOK, YOUTUBE, or INTERNAL).
- 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.
- restricted Boolean
- True when the workspace's legacy per-creator plan limit hides this item's preview and public link in the Archive app (its creator falls outside the plan's creator limit and the item is not in any of the workspace's collections). False otherwise, including on every plan priced by monthly content volume. The API still returns the full item.
- sentiment ItemSentiment
- AI-classified sentiment of the content, from the workspace's
sentimentcustom attribute. Null when the item has not been classified or the workspace does not run sentiment analysis. - MIXED
- Both positive and negative sentiment (stored as
Mixed). - NEGATIVE
- Negative sentiment (stored as
Negative). - NEUTRAL
- Neutral sentiment (stored as
Neutral). - NOT_APPLICABLE
- Sentiment does not apply to the content (stored as
Not Applicable). - POSITIVE
- Positive sentiment (stored as
Positive). - socialProfile SocialProfile!
- Social media profile on which this content was posted.
- 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:): anaftercursor applies to every creator in the response. - action ActivityLogAction! Continue in ActivityLogAction →
- What kind of change the entry records.
- 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! Continue in ActivityLogActorType →
- Whether a workspace member or Archive made the change.
- field String
- The changed field, such as
custom_attributes.labelsorinfluencers(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
campaignslists, newest campaign first. Pass one tocampaign(id:). Empty when the creator is on none. - createdAt DateTime!
- When the creator was added to the workspace (UTC).
creatorslists 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_namecustom 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
locationsfilter ofcreatorsmatches. 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
LocationCanonicalInputfilters, withstateholding the region.nameis 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 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
engagementsImpressionsfor 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
engagementsImpressionsAvgfor 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.
- sourceIds [ID!]!
- IDs of the workspace sources (tracked hashtags, mentions or accounts) that captured this item. The same IDs
ItemFilterInput.sourcesIdstakes. Empty when no source captured it (for example a manual upload). - takenAt DateTime!
- Timestamp when the content was originally published on the social platform (UTC).
- thumbnailUrl String
- URL of a preview image for the item: the first of its media contents'
thumbnailUrlthat is available. Null when no content has a preview. - transcriptions [Transcription!]!
- Text transcriptions and subtitles generated for video content within this item.
- mediaContentId ID!
- Identifier of the media content this transcription belongs to.
- transcript String
- Plain text transcription of the spoken content.
- type ItemType!
- Type of archived content (for example POST, REEL, STORY or SHORT), depending on the platform. Platform-neutral: read it together with
provider.ItemFilterInput.itemTypesuses platform-qualified values instead (a TikTok POST is filtered asTIKTOK). - 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.
- usageRights ItemUsageRights paginated
- The usage-rights, Instagram Partnership Ad and TikTok Spark Ad requests the workspace sent the creator for this item, one entry per request, newest first. An item matched by
ItemFilterInput.usageRightsStatus,instagramWhitelistingStatusortiktokSparkCodeStatushas an entry with that scope and status. Paginated withfirst(default 20, maximum 100) andafter;totalCountis computed only when selected. Empty when none was requested. - scopes [ItemUsageRightsScope!]!
- What the request covers: usage rights, an Instagram Partnership Ad code, a TikTok Spark Ad code, or a combination.
- INSTAGRAM_WHITELISTING
- An Instagram Partnership Ad code (whitelisting). Filtered by
instagramWhitelistingStatus. - TIKTOK_SPARK_CODE
- A TikTok Spark Ad code. Filtered by
tiktokSparkCodeStatus. - USAGE_RIGHTS
- Rights to reuse the content. Filtered by
usageRightsStatus. - status ItemUsageRightsStatus
- Current status of the request. A request whose status was cleared reads as APPROVED once it was approved, REQUESTED once it was sent, and IN_QUEUE otherwise, as in the app. Null only when the stored status is not a recognized value.
- APPROVED
- Contract has been approved by the creator.
- EXPIRED
- Contract approval has expired.
- FAILED
- Sending the request to the creator failed. Not a filter value.
- IN_QUEUE
- Contract request is queued for processing.
- REJECTED
- Contract request was rejected by the creator.
- REQUESTED
- Contract has been requested but not yet responded to.
- nodes [Item!]!
- List of items.
- aiFilterReasons [AiFilterReason!]!
- Explanations the AI Filters produced for this item's AI-generated custom attributes, one entry per AI-generated attribute the item has. Pair each entry to its value by
keyincustomAttributes;customAttributeSchemasmarks which keys are AI-generated viaaiGenerated. Empty when the item has none. - key String!
- Custom-attribute key this explanation belongs to. Matches a key in
customAttributesand thekeyof acustomAttributeSchemasentry. - reason String
- The AI Filter's explanation for the value it assigned. Null when the run recorded no explanation; an empty string is returned verbatim when the model produced one.
- archivePublicUrl String
- Stable Archive permalink for this item. Unlike
originalUrl, this URL keeps resolving after the source post is deleted or the creator account goes private. - caption String
- Caption text of the content, when available.
- coAuthors [SocialProfile!]!
- Other social profiles credited as co-authors of a collaborative post, excluding
socialProfileitself. Empty for a single-author post. - 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:): anaftercursor 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.labelsorinfluencers(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
campaignslists, newest campaign first. Pass one tocampaign(id:). Empty when the creator is on none. - createdAt DateTime!
- When the creator was added to the workspace (UTC).
creatorslists 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_namecustom 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
locationsfilter ofcreatorsmatches. 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
LocationCanonicalInputfilters, withstateholding the region.nameis 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 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
engagementsImpressionsfor 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
engagementsImpressionsAvgfor 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.
- createdAt DateTime!
- Timestamp when Archive ingested the item into this workspace (UTC). Compare
takenAt, the publication time on the platform. - creator Creator!
- Creator who posted this content.
- 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:): anaftercursor 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.labelsorinfluencers(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
campaignslists, newest campaign first. Pass one tocampaign(id:). Empty when the creator is on none. - createdAt DateTime!
- When the creator was added to the workspace (UTC).
creatorslists 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_namecustom 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
locationsfilter ofcreatorsmatches. 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!]!
- Social media profiles linked to this creator across all platforms (for example Instagram, TikTok, YouTube). Returns an empty list if no profiles are linked.
- 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 ↻ circular view 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.
- 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
LocationCanonicalInputfilters, withstateholding the region.nameis 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 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
engagementsImpressionsfor 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
engagementsImpressionsAvgfor 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.
- currentEngagement Engagement
- Most recent engagement metrics (likes, comments, impressions, shares, EMV) and virality score for this item. Read
impressionsfor 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
impressionsfor views, plays, or reach. - customAttributes JSON!
- Custom metadata fields associated with the item.
- customProduct ItemCustomProduct
- The custom product (a link with a call to action) attached to this item. Null when none is attached.
- action String
- Call-to-action label shown with the link (for example "Buy now").
- id ID!
- Unique identifier of the custom product in Archive.
- title String!
- Product title. May be empty.
- url String
- Link the custom product points to.
- detectedPaidPartnership Boolean!
- Whether Archive's AI classifier detected a paid partnership (sponsored, affiliate, collab or gifted content) on this item. Reflects AI detection only: a native platform paid-partnership disclosure on its own does not make this true. See
detectedPaidPartnershipDetailsfor the classifier's reasoning. - detectedPaidPartnershipDetails DetectedPaidPartnershipDetails
- The AI classifier's detection details for this item. Null when
detectedPaidPartnershipis false. - partnershipType String
- Kind of partnership the classifier detected:
sponsored,affiliate,collaborgifted. Returned as a plain string so new kinds can appear without a schema change; treat an unrecognized value as a generic paid partnership. Null when the classifier recorded no type. - reasoning String
- The classifier's one-sentence explanation of why it detected a paid partnership, returned verbatim. Null when the classifier recorded no explanation.
- externalId ID!
- Platform-specific identifier for the content (e.g., Instagram post ID, TikTok video ID).
- hashtags [String!]
- List of hashtags used in the item’s caption or metadata.
- id ID!
- Unique identifier for the item in Archive's system.
- location Location
- Location associated with the content, if present.
- 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.
- mediaItemId ID!
- Identifier of the parent media item. Use this to group related contents (e.g., carousel frames) that belong to the same post.
- mentions [String!]
- List of user mentions used in the item’s caption or metadata.
- originalUrl String
- Direct URL to the original content on the social platform. Returns null for content types without public URLs (e.g., Instagram Stories).
- products ItemProduct paginated
- Products from the workspace's Shopify catalog linked to this item, by a person or by Archive's product detection, ordered by product ID. Paginated with
first(default 20, maximum 100) andafter;totalCountis computed only when selected. Empty when none is linked. - externalId ID
- Shopify product ID, when known.
- handle String
- Shopify product handle (the URL slug of the product page), when known.
- id ID!
- Unique identifier of the product in Archive. Pass it to
ItemFilterInput.shopifyProductsIdsto find other items linked to the same product. - title String!
- Product title.
- provider Provider!
- Platform where the content exists (for example INSTAGRAM, TIKTOK, YOUTUBE, or INTERNAL).
- 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.
- restricted Boolean
- True when the workspace's legacy per-creator plan limit hides this item's preview and public link in the Archive app (its creator falls outside the plan's creator limit and the item is not in any of the workspace's collections). False otherwise, including on every plan priced by monthly content volume. The API still returns the full item.
- sentiment ItemSentiment
- AI-classified sentiment of the content, from the workspace's
sentimentcustom attribute. Null when the item has not been classified or the workspace does not run sentiment analysis. - MIXED
- Both positive and negative sentiment (stored as
Mixed). - NEGATIVE
- Negative sentiment (stored as
Negative). - NEUTRAL
- Neutral sentiment (stored as
Neutral). - NOT_APPLICABLE
- Sentiment does not apply to the content (stored as
Not Applicable). - POSITIVE
- Positive sentiment (stored as
Positive). - socialProfile SocialProfile!
- Social media profile on which this content was posted.
- 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:): anaftercursor 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.labelsorinfluencers(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
campaignslists, newest campaign first. Pass one tocampaign(id:). Empty when the creator is on none. - createdAt DateTime!
- When the creator was added to the workspace (UTC).
creatorslists 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_namecustom 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
locationsfilter ofcreatorsmatches. 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
LocationCanonicalInputfilters, withstateholding the region.nameis 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 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
engagementsImpressionsfor 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
engagementsImpressionsAvgfor 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.
- sourceIds [ID!]!
- IDs of the workspace sources (tracked hashtags, mentions or accounts) that captured this item. The same IDs
ItemFilterInput.sourcesIdstakes. Empty when no source captured it (for example a manual upload). - takenAt DateTime!
- Timestamp when the content was originally published on the social platform (UTC).
- thumbnailUrl String
- URL of a preview image for the item: the first of its media contents'
thumbnailUrlthat is available. Null when no content has a preview. - transcriptions [Transcription!]!
- Text transcriptions and subtitles generated for video content within this item.
- mediaContentId ID!
- Identifier of the media content this transcription belongs to.
- transcript String
- Plain text transcription of the spoken content.
- type ItemType!
- Type of archived content (for example POST, REEL, STORY or SHORT), depending on the platform. Platform-neutral: read it together with
provider.ItemFilterInput.itemTypesuses platform-qualified values instead (a TikTok POST is filtered asTIKTOK). - 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.
- usageRights ItemUsageRights paginated
- The usage-rights, Instagram Partnership Ad and TikTok Spark Ad requests the workspace sent the creator for this item, one entry per request, newest first. An item matched by
ItemFilterInput.usageRightsStatus,instagramWhitelistingStatusortiktokSparkCodeStatushas an entry with that scope and status. Paginated withfirst(default 20, maximum 100) andafter;totalCountis computed only when selected. Empty when none was requested. - scopes [ItemUsageRightsScope!]!
- What the request covers: usage rights, an Instagram Partnership Ad code, a TikTok Spark Ad code, or a combination.
- INSTAGRAM_WHITELISTING
- An Instagram Partnership Ad code (whitelisting). Filtered by
instagramWhitelistingStatus. - TIKTOK_SPARK_CODE
- A TikTok Spark Ad code. Filtered by
tiktokSparkCodeStatus. - USAGE_RIGHTS
- Rights to reuse the content. Filtered by
usageRightsStatus. - status ItemUsageRightsStatus
- Current status of the request. A request whose status was cleared reads as APPROVED once it was approved, REQUESTED once it was sent, and IN_QUEUE otherwise, as in the app. Null only when the stored status is not a recognized value.
- APPROVED
- Contract has been approved by the creator.
- EXPIRED
- Contract approval has expired.
- FAILED
- Sending the request to the creator failed. Not a filter value.
- IN_QUEUE
- Contract request is queued for processing.
- REJECTED
- Contract request was rejected by the creator.
- REQUESTED
- Contract has been requested but not yet responded to.
- pageInfo PageInfo!
- Pagination information.
- endCursor String
- Cursor for the last node in this page.
- hasNextPage Boolean!
- Whether there are more results after this page.
- hasPreviousPage Boolean!
- Whether there are results before this page.
- startCursor String
- Cursor for the first node in this page.
- totalCount Int
- Total number of items available.