Query

creators

List and paginate creators for the current workspace, ordered newest first.

Paginated · weighted cost MCP: searchCreators

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.
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).
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.
filter CreatorFilterInput default {}: Filter criteria to narrow down results (e.g. by campaign roster or canonical location).
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.
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.
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 filter and customAttributeConditions are ignored; the view's stored conditions and sortBy drive the result set. The view's stored filters blob is not applied; a view whose only narrowing lives in filters returns the whole workspace. Accepts IDs returned by creatorViews / creatorView (workspace Creator Views, generally available), or by campaignCreatorViews(campaignId:) / campaignCreatorView(id:) (campaign-scoped, in alpha; opt in with the campaign_creator_views header). Non-Creator-View IDs raise a GraphQL error with extensions.code = "WRONG_VIEW_TYPE"; cross-shop or unknown IDs raise with extensions.code = "NOT_FOUND".

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.
customAttributes JSON!: Custom metadata fields associated with the creator (for example CRM attributes).
id ID!: Unique identifier for the creator in Archive's system.
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.
avatar String: URL of the account's profile picture, if available.
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.
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.
verified Boolean!: Whether the account has a verified/badge status on the platform.
nodes [Creator!]!: List of creators.
customAttributes JSON!: Custom metadata fields associated with the creator (for example CRM attributes).
id ID!: Unique identifier for the creator in Archive's system.
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.
avatar String: URL of the account's profile picture, if available.
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.
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.
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.

query CreatorsDefault($first: Int, $after: String) { creators(first: $first, after: $after) { totalCount edges { node { id customAttributes socialProfiles { accountName provider followers } } } pageInfo { hasNextPage endCursor } } }

{ "data": { "creators": { "totalCount": 10, "edges": [ { "node": { "id": "5e6f95ca-070b-5cef-8e0c-08d855365419", "customAttributes": { "age": null, "emails": [], "gender": "45b18b20-e86d-5c85-831c-19ada8104b25", "location": "United States", "full_name": null, "phone_numbers": [] }, "socialProfiles": [ { "accountName": "northwind_creator_9", "provider": "INSTAGRAM", "followers": 41500 } ] } }, { "node": { "id": "7750875f-6037-5751-a493-86ac5fc3e9c9", "customAttributes": { "age": null, "emails": [], "gender": "52e6750a-79ca-5f7e-9352-228c7b9cb18f", "location": "United States", "full_name": null, "phone_numbers": [] }, "socialProfiles": [ { "accountName": "northwind_creator_8", "provider": "YOUTUBE", "followers": 38000 } ] } }, { "node": { "id": "75fd5375-7f33-5331-a6cf-86e0c697c6f6", "customAttributes": { "age": null, "emails": [], "gender": "45b18b20-e86d-5c85-831c-19ada8104b25", "location": "United States", "full_name": null, "phone_numbers": [] }, "socialProfiles": [ { "accountName": "northwind_creator_7", "provider": "TIKTOK", "followers": 34500 } ] } }, { "node": { "id": "ffe08e5e-e2f7-5dc3-813c-8b47d419f486", "customAttributes": { "age": null, "emails": [], "gender": "52e6750a-79ca-5f7e-9352-228c7b9cb18f", "location": "United States", "full_name": null, "phone_numbers": [] }, "socialProfiles": [ { "accountName": "northwind_creator_6", "provider": "INSTAGRAM", "followers": 31000 } ] } }, { "node": { "id": "4fe7f884-6b21-5046-b965-b05e5b3aa957", "customAttributes": { "age": null, "emails": [], "gender": "45b18b20-e86d-5c85-831c-19ada8104b25", "location": "United States", "full_name": null, "phone_numbers": [] }, "socialProfiles": [ { "accountName": "northwind_creator_5", "provider": "YOUTUBE", "followers": 27500 } ] } }, { "node": { "id": "3c132758-248e-542b-9219-dd949ad0f90e", "customAttributes": { "age": null, "emails": [], "gender": "52e6750a-79ca-5f7e-9352-228c7b9cb18f", "location": "Northwind HQ 4", "full_name": null, "phone_numbers": [] }, "socialProfiles": [ { "accountName": "northwind_creator_4", "provider": "TIKTOK", "followers": 24000 } ] } }, { "node": { "id": "3d20f735-5ff1-5756-af1b-ff3a7315265b", "customAttributes": { "age": null, "emails": [], "gender": "45b18b20-e86d-5c85-831c-19ada8104b25", "location": "Northwind HQ 3", "full_name": null, "phone_numbers": [] }, "socialProfiles": [ { "accountName": "northwind_creator_3", "provider": "INSTAGRAM", "followers": 20500 } ] } }, { "node": { "id": "13d02f43-65cb-55fb-a558-a89100226d58", "customAttributes": { "age": null, "emails": [], "gender": "52e6750a-79ca-5f7e-9352-228c7b9cb18f", "location": "Northwind HQ 2", "full_name": null, "phone_numbers": [] }, "socialProfiles": [ { "accountName": "northwind_creator_2", "provider": "YOUTUBE", "followers": 17000 } ] } }, { "node": { "id": "c36d2c62-26da-5c7b-b198-b8f028209c4f", "customAttributes": { "age": null, "emails": [], "gender": "45b18b20-e86d-5c85-831c-19ada8104b25", "location": "Northwind HQ 1", "full_name": null, "phone_numbers": [] }, "socialProfiles": [ { "accountName": "northwind_creator_1", "provider": "TIKTOK", "followers": 13500 } ] } }, { "node": { "id": "01f0f8f3-97dd-597c-8cc1-cf75eaabddb0", "customAttributes": { "age": null, "emails": [], "gender": "52e6750a-79ca-5f7e-9352-228c7b9cb18f", "location": "Northwind HQ 0", "full_name": null, "phone_numbers": [] }, "socialProfiles": [ { "accountName": "northwind_creator_0", "provider": "INSTAGRAM", "followers": 10000 } ] } } ], "pageInfo": { "hasNextPage": false, "endCursor": "Z2lkOi8vYXJjaGl2ZS9DcmVhdG9yLzAxZjBmOGYzLTk3ZGQtNTk3Yy04Y2MxLWNmNzVlYWFiZGRiMA==" } } } }

query CreatorsCustomAttributeCondition($customAttributeConditions: [CustomAttributeConditionInput!], $first: Int) { creators(customAttributeConditions: $customAttributeConditions, first: $first) { totalCount edges { node { id customAttributes } } } }

{ "data": { "creators": { "totalCount": 5, "edges": [ { "node": { "id": "3c132758-248e-542b-9219-dd949ad0f90e", "customAttributes": { "age": null, "emails": [], "gender": "52e6750a-79ca-5f7e-9352-228c7b9cb18f", "location": "Northwind HQ 4", "full_name": null, "phone_numbers": [] } } }, { "node": { "id": "3d20f735-5ff1-5756-af1b-ff3a7315265b", "customAttributes": { "age": null, "emails": [], "gender": "45b18b20-e86d-5c85-831c-19ada8104b25", "location": "Northwind HQ 3", "full_name": null, "phone_numbers": [] } } }, { "node": { "id": "13d02f43-65cb-55fb-a558-a89100226d58", "customAttributes": { "age": null, "emails": [], "gender": "52e6750a-79ca-5f7e-9352-228c7b9cb18f", "location": "Northwind HQ 2", "full_name": null, "phone_numbers": [] } } }, { "node": { "id": "c36d2c62-26da-5c7b-b198-b8f028209c4f", "customAttributes": { "age": null, "emails": [], "gender": "45b18b20-e86d-5c85-831c-19ada8104b25", "location": "Northwind HQ 1", "full_name": null, "phone_numbers": [] } } }, { "node": { "id": "01f0f8f3-97dd-597c-8cc1-cf75eaabddb0", "customAttributes": { "age": null, "emails": [], "gender": "52e6750a-79ca-5f7e-9352-228c7b9cb18f", "location": "Northwind HQ 0", "full_name": null, "phone_numbers": [] } } } ] } } }