Query

campaignCreators

Paginate one campaign's roster, newest first, with each creator's campaign-specific custom attributes. An unknown campaign ID, or one from another workspace, returns a NOT_FOUND error. Paging is offset-based: rows added or removed between pages can be skipped or returned twice.

Paginated · weighted cost MCP: getCampaignCreators

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 default null: Cursor for fetching the next page of results.
campaignId ID! required: ID of the campaign whose roster to page through (as returned by campaigns).
customAttributeConditions [CustomAttributeConditionInput!] default []: Conditions on the campaign creator custom attributes, combined with AND. Read the keys with customAttributeSchemas(entity: CAMPAIGN_CREATOR). Three creator-level fields are also accepted: labels, creator_name and posting_activity (IS or IS_NOT, value "posted" or "not_posted"). Each of these three takes one condition at most. post_date and collections are refused with UNSUPPORTED_CUSTOM_ATTRIBUTE_CONDITION.
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: 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.
first Int default 20: Number of campaign creators to return (page size).
sorting [CampaignCreatorSortingInput!] default [{sortKey: ADDED_AT, sortOrder: DESC}]: Sorting instructions to apply to the roster. Ties break on the roster entry ID.
sortKey CampaignCreatorSortKey! required: Which field to sort campaign creators by.
ADDED_AT: When the creator joined the campaign roster.
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 CampaignCreator nodes. See Pagination for the connection shape.

edges [CampaignCreatorEdge!]!: List of edges with cursors.
cursor String!: Cursor for this node.
node CampaignCreator!: The campaign creator.
addedAt DateTime!: When the creator joined the campaign roster (UTC).
creator Creator!: The creator on the roster.
avatar String: URL of the profile picture of the creator's earliest-linked social profile; null when there is none.
campaignIds [ID!]!: Ids of the campaigns this creator is on, limited to the campaigns campaigns lists, newest campaign first. Pass one to campaign(id:). Empty when the creator is on none.
createdAt DateTime!: When the creator was added to the workspace (UTC). creators lists newest first by this value.
customAttributes JSON!: Custom metadata fields associated with the creator (for example CRM attributes).
displayName String: Name to show for the creator: the full_name custom attribute, else the handle of the creator's earliest-linked social profile. Null when neither is set.
id ID!: Unique identifier for the creator in Archive's system.
location CreatorLocation: Canonical location Archive resolved for the creator, the value the locations filter of creators matches. Null when no country has been resolved.
city String: Canonical city (for example "Portland"); null when not resolved.
country String!: Canonical country name (for example "United States").
region String: Canonical region, state or province (for example "Oregon"); null when not resolved.
socialProfiles [SocialProfile!]!: 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 LocationCanonicalInput filters, with state holding the region. name is always null. Returns null when no location is resolved.
city String: City associated with the location.
country String: Country associated with the location.
formatted String: Human-readable formatted address.
name String: Full name of the location.
state String: State, region, or province associated with the location.
originalUrl String!: Direct URL to the profile on the social platform (e.g., https://instagram.com/account_name).
phoneNumbers [String!]: Phone numbers associated with the account, when present.
private Boolean!: Whether the social media account is currently set to private.
proAccount Boolean!: Whether the account is marked as a professional or business account on the platform.
provider Provider!: Platform where the social profile exists (for example INSTAGRAM, TIKTOK, YOUTUBE, or INTERNAL).
INSTAGRAM: Instagram platform integration, including posts, reels, stories, and profile data.
INTERNAL: Internal Archive-managed source used for synthetic or system-generated content.
TIKTOK: TikTok platform integration, including videos and creator profile data.
YOUTUBE: YouTube platform integration, including Shorts, videos, thumbnails, and profile data.
stats SocialProfileStats: Content counts and last-month engagement stats, as the Archive app shows them. Returns null when Archive holds no content for the profile.
engagementsComments BigInt!: Total comments over the last month.
engagementsCommentsAvg Float!: Average comments per item over the last month, rounded to a whole number.
engagementsEmv BigInt!: Total estimated earned media value (EMV) over the last month, in cents.
engagementsEmvAvg Float!: Average estimated earned media value per item over the last month, in cents.
engagementsEmvRate Float!: Average earned media value divided by followers over the last month.
engagementsImpressions BigInt!: Total impressions (views and plays) over the last month.
engagementsImpressionsAvg Float!: Average impressions per item over the last month, rounded to a whole number.
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 over the last month.
engagementsViewsAvg Float!: Average views per item over the last month, rounded to a whole number.
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.
customAttributes JSON!: Campaign-specific values for this creator, such as gifting, shipping or contract status. Read the keys with customAttributeSchemas(entity: CAMPAIGN_CREATOR).
id ID!: Unique identifier of this roster entry. It differs from the creator ID.
nodes [CampaignCreator!]!: List of campaign creators.
addedAt DateTime!: When the creator joined the campaign roster (UTC).
creator Creator!: The creator on the roster.
avatar String: URL of the profile picture of the creator's earliest-linked social profile; null when there is none.
campaignIds [ID!]!: Ids of the campaigns this creator is on, limited to the campaigns campaigns lists, newest campaign first. Pass one to campaign(id:). Empty when the creator is on none.
createdAt DateTime!: When the creator was added to the workspace (UTC). creators lists newest first by this value.
customAttributes JSON!: Custom metadata fields associated with the creator (for example CRM attributes).
displayName String: Name to show for the creator: the full_name custom attribute, else the handle of the creator's earliest-linked social profile. Null when neither is set.
id ID!: Unique identifier for the creator in Archive's system.
location CreatorLocation: Canonical location Archive resolved for the creator, the value the locations filter of creators matches. Null when no country has been resolved.
city String: Canonical city (for example "Portland"); null when not resolved.
country String!: Canonical country name (for example "United States").
region String: Canonical region, state or province (for example "Oregon"); null when not resolved.
socialProfiles [SocialProfile!]!: 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 LocationCanonicalInput filters, with state holding the region. name is always null. Returns null when no location is resolved.
city String: City associated with the location.
country String: Country associated with the location.
formatted String: Human-readable formatted address.
name String: Full name of the location.
state String: State, region, or province associated with the location.
originalUrl String!: Direct URL to the profile on the social platform (e.g., https://instagram.com/account_name).
phoneNumbers [String!]: Phone numbers associated with the account, when present.
private Boolean!: Whether the social media account is currently set to private.
proAccount Boolean!: Whether the account is marked as a professional or business account on the platform.
provider Provider!: Platform where the social profile exists (for example INSTAGRAM, TIKTOK, YOUTUBE, or INTERNAL).
INSTAGRAM: Instagram platform integration, including posts, reels, stories, and profile data.
INTERNAL: Internal Archive-managed source used for synthetic or system-generated content.
TIKTOK: TikTok platform integration, including videos and creator profile data.
YOUTUBE: YouTube platform integration, including Shorts, videos, thumbnails, and profile data.
stats SocialProfileStats: Content counts and last-month engagement stats, as the Archive app shows them. Returns null when Archive holds no content for the profile.
engagementsComments BigInt!: Total comments over the last month.
engagementsCommentsAvg Float!: Average comments per item over the last month, rounded to a whole number.
engagementsEmv BigInt!: Total estimated earned media value (EMV) over the last month, in cents.
engagementsEmvAvg Float!: Average estimated earned media value per item over the last month, in cents.
engagementsEmvRate Float!: Average earned media value divided by followers over the last month.
engagementsImpressions BigInt!: Total impressions (views and plays) over the last month.
engagementsImpressionsAvg Float!: Average impressions per item over the last month, rounded to a whole number.
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 over the last month.
engagementsViewsAvg Float!: Average views per item over the last month, rounded to a whole number.
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.
customAttributes JSON!: Campaign-specific values for this creator, such as gifting, shipping or contract status. Read the keys with customAttributeSchemas(entity: CAMPAIGN_CREATOR).
id ID!: Unique identifier of this roster entry. It differs from the creator ID.
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.

query CampaignCreatorsDefault($campaignId: ID!, $first: Int, $after: String) { campaignCreators(campaignId: $campaignId, first: $first, after: $after) { totalCount edges { node { id addedAt customAttributes creator { id } } } pageInfo { hasNextPage endCursor } } }

{ "data": { "campaignCreators": { "totalCount": 3, "edges": [ { "node": { "id": "959daa0a-069a-583a-b340-f91de3bfef6f", "addedAt": "2024-12-31T23:00:00Z", "customAttributes": { "status": "not_posted" }, "creator": { "id": "13d02f43-65cb-55fb-a558-a89100226d58" } } }, { "node": { "id": "3724d187-21e8-55d1-9c1f-def3443116b0", "addedAt": "2024-12-31T22:00:00Z", "customAttributes": { "status": "not_posted" }, "creator": { "id": "c36d2c62-26da-5c7b-b198-b8f028209c4f" } } }, { "node": { "id": "4284d871-3dff-5205-b40d-50c5ce9a88a6", "addedAt": "2024-12-31T21:00:00Z", "customAttributes": { "status": "not_posted" }, "creator": { "id": "01f0f8f3-97dd-597c-8cc1-cf75eaabddb0" } } } ], "pageInfo": { "hasNextPage": false, "endCursor": null } } } }