Query

socialProfile

Return details for a social profile by ID or account identifier.

**Errors:** When fallback: true triggers a live lookup and the upstream social-platform service returns a transient failure, this query returns a GraphQL error with extensions.code = "UPSTREAM_UNAVAILABLE" and extensions.provider set to the requested platform. Clients should treat this as retriable (the upstream blip is usually short-lived); switch on the stable extensions.code rather than the message text.

MCP: getSocialProfile

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.

accountName String: Username or handle on the social platform (e.g., "nike" for instagram.com/nike).
fallback Boolean default false: When true, fetches profile from social platform if not archived locally. May increase response time.
id ID: Unique identifier of the social profile within your workspace.
provider Provider: Social platform: instagram, tiktok, or youtube. Required when using account_name.
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.

Returns

Returns SocialProfile .

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!]!: 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.
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.

query SocialProfileDefault($accountName: String, $provider: Provider) { socialProfile(accountName: $accountName, provider: $provider) { id accountName fullName provider followers following verified originalUrl } }

{ "data": { "socialProfile": { "id": "1915685", "accountName": "northwind_creator_0", "fullName": null, "provider": "INSTAGRAM", "followers": 10000, "following": 0, "verified": false, "originalUrl": "https://instagram.com/northwind_creator_0" } } }