Query
creators
List and paginate creators for the current workspace, ordered newest first unless sorting or a presetId view says otherwise.
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.
- applyViewFilters Boolean default false
- When true and
presetIdis a workspace Creator View, also narrow by the view's storedfiltersblob, the way the app's Creators page does: linked handles (accountNames) and canonical locations (locationsCanonical, including region groups such as{group: "dach"}). Other stored keys and unreadable values are ignored. Campaign Creator Views and calls withoutpresetIdare unaffected. Defaults to false. - customAttributeConditions [CustomAttributeConditionInput!] default []
- Creator custom attributes 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 CreatorFilterInput default {}
- Filter criteria to narrow down results (e.g. by campaign roster, handle or canonical location).
- accountNames [String!] default []
- Filter to creators with a linked social profile whose handle matches any of the given values. A bare handle (e.g. "janedoe") matches on every platform; prefix it with the provider (
instagram:,tiktok:oryoutube:, e.g. "tiktok:janedoe") to match that platform only. Matching ignores case; multiple handles OR together; an empty or omitted list leaves the result set unconstrained. - campaignsIds [ID!] default []
- Filter to creators on the roster of any of the given campaign IDs (the IDs returned by
campaigns). Multiple IDs OR together; an empty or omitted list leaves the result set unconstrained. IDs from another workspace match nothing. - locations [LocationCanonicalInput!]
- Filter creators by canonical location. Each entry ANDs its populated components (country/region/city); multiple entries OR together, which is useful for disambiguating same-named cities (e.g. Portland, Oregon vs. Portland, Maine). Canonical values come from the Geo normalization pipeline; omit a component to leave it unconstrained. An entry may instead name a region group (
group, a code fromlocationGroups), which matches creators in any of its member countries. - 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.
- first Int default 20
- Number of creators to return (page size).
- presetId ID default null
- Saved Creator View ID. When provided, inline
filterandcustomAttributeConditionsare ignored; the view's stored conditions and sortBy drive the result set. A workspace Creator View's storedfiltersblob is applied only withapplyViewFilters: true; otherwise a view whose only narrowing lives infiltersreturns the whole workspace. Accepts IDs returned bycreatorViews/creatorView(workspace Creator Views, generally available), or bycampaignCreatorViews(campaignId:)/campaignCreatorView(id:)(campaign-scoped, in alpha; opt in with thecampaign_creator_viewsheader). A campaign Creator View returns only the creators on its campaign. Non-Creator-View IDs raise a GraphQL error withextensions.code = "WRONG_VIEW_TYPE"; cross-workspace or unknown IDs raise withextensions.code = "NOT_FOUND". - sorting [CreatorSortingInput!] default null
- Sort configuration: a list of at most one entry (compound sort is not supported). When given it wins over the stored sort of a
presetIdview; when omitted the view's stored sort applies, or newest first ([{ sortKey: CREATED_AT, sortOrder: DESC }]) without a view. Ties are broken by creator ID, ascending. Keep the samesortingwhile followingendCursor. - sortKey CreatorSortKey! required
- Which field to sort creators by.
- CREATED_AT
- Sort by when the creator was added to the workspace.
- FULL_NAME
- Sort by the creator's full name, ignoring case. Creators without a full name sort last.
- 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 Creator nodes. See Pagination for the connection shape.
- edges [CreatorEdge!]!
- List of edges with cursors.
- cursor String!
- Cursor for this node.
- node Creator!
- The creator.
- 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.
- nodes [Creator!]!
- List of creators.
- 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.
- 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.