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. Pagination has no page-depth cap, so every page of a large workspace stays reachable; under the default sort each page resumes after the previous page's last profile, so a deep page costs about the same as the first. - applyViewFilters Boolean default false
- When true and
presetIdis set, also narrow by the view's storedfiltersblob, the way the app's Social Profiles page does: handles (accountNames), creator ids, platform, item and content types, engagement, follower count, verified, publication date, posting activity, tags and sources. Other stored keys and unreadable values are ignored. Has no effect withoutpresetId. Defaults to false. - customAttributeConditions [CustomAttributeConditionInput!] default []
- Conditions on the custom attributes of the creator linked to each profile, AND-ed with
filter. Same input and rules ascreators(customAttributeConditions:); a condition the search cannot evaluate returnsextensions.code = "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 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 SocialProfileFilterInput default {}
- Filter criteria to narrow down results (e.g. by platform, handle, follower count, posting activity, tags or sources), matching the workspace Social Profiles page.
- accountNames [String!]
- Profiles with any of these handles (case-insensitive). A bare handle (
"nike") matches on every platform; aplatform:handlevalue ("tiktok:nike") matches only that platform's profile. - contentTypes [MediaContentType!]
- Profiles with archived items of any of these media content types. A profile matches when at least one of its archived items does.
- IMAGE
- Static image content (for example photos, thumbnails, frames).
- VIDEO
- Video content (for example Reels, TikToks, Stories, YouTube videos).
- creatorIds [ID!]
- Profiles linked to any of these creator IDs (as returned by
creators). - engagement [FilterEngagementRangeInput!]
- Engagement-metric ranges; each entry constrains one metric, and a profile matches when one of its archived items falls in every range. Only LIKE_COUNT, COMMENT_COUNT, SHARE_COUNT, MERGED_VIEW_PLAY_COUNT and EARNED_MEDIA_VALUE apply to social profiles; a rate field returns an
INVALID_INPUTerror. - field FilterEngagementField! required
- Engagement metric to filter on.
- COMMENT_COUNT
- Total number of comments.
- EARNED_MEDIA_VALUE
- Estimated earned media value (EMV) in cents.
- ENGAGEMENTS_RATE
- Engagement rate: total engagements divided by the creator's follower count. Bounds are whole percent (5 = 5%); values below 1% are not expressible.
- IMPRESSIONS_RATE
- Impressions rate: views, plays, or estimated impressions divided by the creator's follower count. Bounds are whole percent (5 = 5%); values below 1% are not expressible.
- LIKE_COUNT
- Total number of likes.
- MERGED_VIEW_PLAY_COUNT
- Number of views, plays, or estimated impressions.
- SHARE_COUNT
- Total number of shares.
- range FilterIntegerRangeInput! required
- Inclusive numeric range the metric value must fall within.
- from Int
- Inclusive lower bound. Omit for no lower bound.
- to Int
- Inclusive upper bound. Omit for no upper bound.
- followersCount FilterIntegerRangeInput
- Inclusive follower-count range.
- from Int
- Inclusive lower bound. Omit for no lower bound.
- to Int
- Inclusive upper bound. Omit for no upper bound.
- itemTypes [FilterItemType!]
- Profiles with archived items of any of these types. A profile matches when at least one of its archived items does. Each value names a platform and a format together (a TikTok post is TIKTOK, not POST).
- POST
- Instagram feed post.
- REEL
- Instagram Reel.
- STORY
- Instagram Story.
- TIKTOK
- TikTok video post.
- TIKTOK_STORY
- TikTok Story.
- YOUTUBE
- YouTube video.
- YOUTUBE_SHORT
- YouTube Short.
- 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.
- postingActivity FilterPostingActivity
- POSTED for profiles with archived content, NOT_POSTED for profiles without. POSTED with
takenAt(both bounds) keeps profiles that posted inside that range. NOT_POSTED combined withtakenAtor apost_datecondition returns anINVALID_INPUTerror. - NOT_POSTED
- The profile has no archived content.
- POSTED
- The profile has archived content (inside
takenAtwhen it is set). - sourcesIds [ID!]
- Source IDs on the profile's archived items, applied with
sourcesIdsOperator. A value that is not a numeric source ID returns anINVALID_INPUTerror. - sourcesIdsOperator FilterOperator
- How
sourcesIdsapplies across all of a profile's archived items. Accepts CONTAINS (the default when omitted: any of the values), DOES_NOT_CONTAIN (none of the values), IS_EMPTY or IS_NOT_EMPTY (the values are ignored); any other operator returns anINVALID_INPUTerror. - 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.
- tagsNames [String!]
- Hashtag or mention tag names on the profile's archived items (maximum 100), applied with
tagsNamesOperator. - tagsNamesOperator FilterOperator
- How
tagsNamesapplies across all of a profile's archived items. Accepts CONTAINS (the default when omitted: any of the values), DOES_NOT_CONTAIN (none of the values), IS_EMPTY or IS_NOT_EMPTY (the values are ignored); any other operator returns anINVALID_INPUTerror. - 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.
- takenAt FilterDateRangeInput
- Publication-date range of the profile's archived items. A profile matches when at least one of its archived items does. Combined with
postingActivity, both bounds are required. - from DateTime
- Inclusive lower bound (ISO 8601). Omit for no lower bound.
- to DateTime
- Inclusive upper bound (ISO 8601). Omit for no upper bound.
- verified Boolean
- true for verified profiles only, false for unverified profiles only.
- first Int default 20
- Number of social profiles to return (page size).
- presetId ID default null
- Saved Social Profile View ID. When provided, inline
filterandcustomAttributeConditionsare ignored; the view's stored customAttributeConditions and sort drive the result set. The view's storedfiltersblob is applied only withapplyViewFilters: true; otherwise 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-workspace 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.
- 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
- 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.
- 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!]! ↻ 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.
- 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 [SocialProfile!]!
- List of social profiles.
- 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
- 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.
- 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!]! ↻ 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.
- 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.