# socialProfile

Query

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.

Available to agents as MCP tool `getSocialProfile` — see [Read tools](/api/v2/docs/mcp/read-tools#get-social-profile).

## Arguments

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `accountName` | `String` | No | — | Username or handle on the social platform (e.g., "nike" for instagram.com/nike). |
| `fallback` | `Boolean` | No | `false` | When true, fetches profile from social platform if not archived locally. May increase response time. |
| `id` | `ID` | No | — | Unique identifier of the social profile within your workspace. |
| `provider` | [`Provider`](/api/v2/docs/types/provider) | No | — | Social platform: instagram, tiktok, or youtube. Required when using `account_name`. |

## Returns

Returns [`SocialProfile`](/api/v2/docs/types/social-profile).

## Examples

### Get a social profile

Look up a social profile by account name and provider.

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

Response — HTTP 200:

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