Query
socialProfiles
List and paginate social profiles for the current workspace. Pass presetId (a Social Profile View id from socialProfileViews / socialProfileView) to drive results off the view's stored conditions and sort; otherwise narrow with filter.
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
- Opaque cursor for fetching the next page. Pass the
pageInfo.endCursorfrom a previous response. Per-node edge cursors are not valid here. - filter SocialProfileFilterInput default {}
- Filter criteria to narrow down results (e.g. by platform).
- platform Provider
- Restrict results to a single social platform (INSTAGRAM, TIKTOK, YOUTUBE, INTERNAL). Maps to the workspace social-profile listing platform filter.
- 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.
- first Int default 20
- Number of social profiles to return (page size).
- presetId ID default null
- Saved Social Profile View ID. When provided, inline
filteris ignored; the view's stored customAttributeConditions and sort drive the result set. The view's storedfiltersblob is not applied; a view whose only narrowing lives infiltersreturns the whole workspace. Accepts IDs returned bysocialProfileViews/socialProfileView. Non-Social-Profile-View IDs raise withextensions.code = "WRONG_VIEW_TYPE"; cross-shop or unknown IDs raise withextensions.code = "NOT_FOUND".
Returns
A paginated connection of SocialProfile nodes. See Pagination for the connection shape.
- edges [SocialProfileEdge!]!
- List of edges with cursors.
- cursor String!
- Cursor for this node.
- node SocialProfile!
- The social profile.
- accountName String!
- Username or handle of the social media account.
- avatar String
- URL of the account's profile picture, if available.
- 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.
- 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!]! ↻ 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.
- 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.
- verified Boolean!
- Whether the account has a verified/badge status on the platform.
- nodes [SocialProfile!]!
- List of social profiles.
- accountName String!
- Username or handle of the social media account.
- avatar String
- URL of the account's profile picture, if available.
- 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.
- 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!]! ↻ 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.
- 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.
- 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.