Archive API docs

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

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.

Returns

Returns SocialProfile .

Open in explorer ↗

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

Look up a social profile by account name and provider.

query.graphql

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

variables.json

{
  "accountName": "northwind_creator_0",
  "provider": "INSTAGRAM"
}

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 SocialProfileDefault($accountName: String, $provider: Provider) {\n  socialProfile(accountName: $accountName, provider: $provider) {\n    id\n    accountName\n    fullName\n    provider\n    followers\n    following\n    verified\n    originalUrl\n  }\n}",
  "variables": {
    "accountName": "northwind_creator_0",
    "provider": "INSTAGRAM"
  }
}'

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 SocialProfileDefault($accountName: String, $provider: Provider) {
  socialProfile(accountName: $accountName, provider: $provider) {
    id
    accountName
    fullName
    provider
    followers
    following
    verified
    originalUrl
  }
}`,
    variables: {
      "accountName": "northwind_creator_0",
      "provider": "INSTAGRAM"
    }
  })
})
console.log(JSON.stringify(await response.json(), null, 2))

Request · Ruby

require "json"
require "net/http"

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

response = Net::HTTP.post(
  URI("https://app.archive.com/api/v2"),
  { query: query, variables: { "accountName" => "northwind_creator_0", "provider" => "INSTAGRAM" } }.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 SocialProfileDefault($accountName: String, $provider: Provider) {
  socialProfile(accountName: $accountName, provider: $provider) {
    id
    accountName
    fullName
    provider
    followers
    following
    verified
    originalUrl
  }
}
"""

response = requests.post(
    "https://app.archive.com/api/v2",
    json={"query": query, "variables": {"accountName": "northwind_creator_0", "provider": "INSTAGRAM"}},
    headers={
        "Authorization": "Bearer docs_demo_token_0000000000000000000000",
        "WORKSPACE-ID": "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
    },
)
print(json.dumps(response.json(), indent=2))

200 OK

{
  "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"
    }
  }
}