Social Profiles

Reminder: All queries on this page require the WORKSPACE-ID header. See Getting Started for setup.

A Social Profile represents a single social media account on a specific platform — one Instagram handle, one TikTok account, one YouTube channel. Each Creator can have multiple social profiles linked to them across different platforms.

Via the API, you can look up a social profile by handle and platform to retrieve follower count, verification status, contact info, and other platform data. This is the same data you see in the Social Profiles page  in the Archive UI.

Terminology note: Some API error messages use the term “influencer” — this refers to the same concept as Social Profile.

Social Profiles vs. Creators

Learn more: Difference Between Creators and Social Profiles 

To look up a creator’s full CRM data, see the Creators page.

All Social Profile fields

Search by handle

query GetSocialProfile {
  socialProfile(accountName: "lauramendez", provider: INSTAGRAM) {
    id
    accountName
    fullName
    provider
    followers
    following
    verified
    proAccount
    private
    avatar
    originalUrl
    email
    phoneNumbers
  }
}

Example response:

{
  "data": {
    "socialProfile": {
      "id": "4829301",
      "accountName": "lauramendez",
      "fullName": "Laura Méndez",
      "provider": "INSTAGRAM",
      "followers": 312000,
      "following": 840,
      "verified": false,
      "proAccount": true,
      "private": false,
      "avatar": "https://cdn.archive.com/avatars/lauramendez.jpg",
      "originalUrl": "https://instagram.com/lauramendez",
      "email": "contact@lauramendez.com",
      "phoneNumbers": []
    }
  }
}

Using with AI:

“Search for the Instagram profile of @lauramendez” “What’s the follower count for this creator on TikTok?” “Check if this account is verified and whether it’s a business account” “Is @lauramendez a business account on Instagram?”

Search by platform

To get all social profiles for a specific platform, query creators and filter by socialProfiles.provider:

query CreatorInstagramProfiles {
  creators(first: 20) {
    nodes {
      id
      customAttributes
      socialProfiles {
        accountName
        provider
        followers
        verified
      }
    }
  }
}

Then filter client-side (or ask Claude) to show only Instagram or TikTok profiles.

Using with AI:

“Show me all Instagram handles for my creators” “List all creators who have a TikTok account” “Find creators who are on both Instagram and YouTube”

Search with fresh platform data

By default, the socialProfile query only looks within Archive’s local cache — the data already stored in your workspace. This means:

• If the profile is archived in your workspace → returns the cached data
• If the profile is not archived → returns an error: "Social profile not archived. Use fallback: true to fetch from instagram."

When you add fallback: true, Archive fetches the data directly from the platform (Instagram, TikTok, or YouTube) in real time, bypassing the cache. This means:

• You can look up any public profile — not just ones in your workspace
• You get the most up-to-date data from the platform at the time of the query
• The WORKSPACE-ID header is still required even with fallback: true

query SocialProfileWithFallback {
  socialProfile(accountName: "lauramendez", provider: INSTAGRAM, fallback: true) {
    id
    accountName
    fullName
    followers
    following
    verified
    proAccount
  }
}

When to use it:

• Looking up a creator’s profile before adding them to your workspace
• Verifying a handle exists on a specific platform
• Getting the most current follower count for a profile

Using with AI:

“Look up the Instagram profile for @cristiano” “Check if @newcreator exists on TikTok and show me their follower count” “Get the latest data for @lauramendez on Instagram”

Get social profiles via the creators query

Social profiles are also available as a nested field when querying creators. This is useful when you want both CRM data and platform stats in a single request:

query CreatorsWithProfiles {
  creators(first: 20) {
    nodes {
      id
      customAttributes
      socialProfiles {
        id
        accountName
        fullName
        provider
        followers
        verified
        proAccount
        email
      }
    }
    pageInfo { hasNextPage endCursor }
  }
}

Using with AI:

“Show me all creators with their Instagram handles and follower counts” “Get every creator’s email and their linked social profiles”