Query

creator

Return details for the creator.

MCP: getCreator

Arguments

id ID! required: Unique identifier for the creator in Archive's system.

Returns

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.

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

Open in explorer ↗

Values are sampled from a demo workspace — substitute your own token and workspace id.

Fetch a single creator and their social profiles by ID.

query.graphql

query CreatorDefault($id: ID!) {
  creator(id: $id) {
    id
    customAttributes
    socialProfiles {
      id
      accountName
      provider
      followers
    }
  }
}

variables.json

{
  "id": "01f0f8f3-97dd-597c-8cc1-cf75eaabddb0"
}

Headers

Authorization: Bearer docs_demo_token_0000000000000000000000
WORKSPACE-ID: 6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a

Request · cURL

curl https://app.archive.com/api/v2 \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer docs_demo_token_0000000000000000000000' \
  -H 'WORKSPACE-ID: 6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a' \
  -d '{
  "query": "query CreatorDefault($id: ID!) {\n  creator(id: $id) {\n    id\n    customAttributes\n    socialProfiles {\n      id\n      accountName\n      provider\n      followers\n    }\n  }\n}",
  "variables": {
    "id": "01f0f8f3-97dd-597c-8cc1-cf75eaabddb0"
  }
}'

Request · Node.js

const response = await fetch("https://app.archive.com/api/v2", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer docs_demo_token_0000000000000000000000",
    "WORKSPACE-ID": "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a"
  },
  body: JSON.stringify({
    query: `query CreatorDefault($id: ID!) {
  creator(id: $id) {
    id
    customAttributes
    socialProfiles {
      id
      accountName
      provider
      followers
    }
  }
}`,
    variables: {
      "id": "01f0f8f3-97dd-597c-8cc1-cf75eaabddb0"
    }
  })
})
console.log(JSON.stringify(await response.json(), null, 2))

Request · Ruby

require "json"
require "net/http"

query = <<~'GRAPHQL'
  query CreatorDefault($id: ID!) {
    creator(id: $id) {
      id
      customAttributes
      socialProfiles {
        id
        accountName
        provider
        followers
      }
    }
  }
GRAPHQL

response = Net::HTTP.post(
  URI("https://app.archive.com/api/v2"),
  { query: query, variables: { "id" => "01f0f8f3-97dd-597c-8cc1-cf75eaabddb0" } }.to_json,
  "Content-Type" => "application/json",
  "Authorization" => "Bearer docs_demo_token_0000000000000000000000",
  "WORKSPACE-ID" => "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a"
)
puts response.body

Request · Python

import json
import requests

query = """
query CreatorDefault($id: ID!) {
  creator(id: $id) {
    id
    customAttributes
    socialProfiles {
      id
      accountName
      provider
      followers
    }
  }
}
"""

response = requests.post(
    "https://app.archive.com/api/v2",
    json={"query": query, "variables": {"id": "01f0f8f3-97dd-597c-8cc1-cf75eaabddb0"}},
    headers={
        "Authorization": "Bearer docs_demo_token_0000000000000000000000",
        "WORKSPACE-ID": "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
    },
)
print(json.dumps(response.json(), indent=2))

200 OK 23 lines

{
  "data": {
    "creator": {
      "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": [
        {
          "id": "1915685",
          "accountName": "northwind_creator_0",
          "provider": "INSTAGRAM",
          "followers": 10000
        }
      ]
    }
  }
}