# socialProfiles

Query

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

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

## Arguments

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `after` | `String` | No | `null` | Opaque cursor for fetching the next page. Pass the `pageInfo.endCursor` from a previous response. Per-node edge cursors are not valid here. |
| `filter` | [`SocialProfileFilterInput`](/api/v2/docs/types/social-profile-filter-input) | No | `{}` | Filter criteria to narrow down results (e.g. by platform). |
| `first` | `Int` | No | `20` | Number of social profiles to return (page size). |
| `presetId` | `ID` | No | `null` | Saved Social Profile View ID. When provided, inline `filter` is ignored; the view's stored customAttributeConditions and sort drive the result set. The view's stored `filters` blob is not applied; a view whose only narrowing lives in `filters` returns the whole workspace. Accepts IDs returned by `socialProfileViews` / `socialProfileView`. Non-Social-Profile-View IDs raise with `extensions.code = "WRONG_VIEW_TYPE"`; cross-shop or unknown IDs raise with `extensions.code = "NOT_FOUND"`. |

## Returns

A paginated connection of [`SocialProfile`](/api/v2/docs/types/social-profile) nodes. See [Pagination](/api/v2/docs/types/pagination) for the connection shape.

## Examples

### List social profiles

Paginate the workspace's social profiles.

```graphql
query SocialProfilesDefault($first: Int, $after: String) {
  socialProfiles(first: $first, after: $after) {
    totalCount
    edges {
      node {
        id
        accountName
        provider
        followers
        verified
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}
```

Variables:

```json
{
  "first": 10
}
```

Response — HTTP 200:

```json
{
  "data": {
    "socialProfiles": {
      "totalCount": 10,
      "edges": [
        {
          "node": {
            "id": "1676439",
            "accountName": "northwind_creator_2",
            "provider": "YOUTUBE",
            "followers": 17000,
            "verified": false
          }
        },
        {
          "node": {
            "id": "1915685",
            "accountName": "northwind_creator_0",
            "provider": "INSTAGRAM",
            "followers": 10000,
            "verified": false
          }
        },
        {
          "node": {
            "id": "1364019",
            "accountName": "northwind_creator_6",
            "provider": "INSTAGRAM",
            "followers": 31000,
            "verified": false
          }
        },
        {
          "node": {
            "id": "1369249",
            "accountName": "northwind_creator_7",
            "provider": "TIKTOK",
            "followers": 34500,
            "verified": false
          }
        },
        {
          "node": {
            "id": "1820294",
            "accountName": "northwind_creator_8",
            "provider": "YOUTUBE",
            "followers": 38000,
            "verified": false
          }
        },
        {
          "node": {
            "id": "1064894",
            "accountName": "northwind_creator_5",
            "provider": "YOUTUBE",
            "followers": 27500,
            "verified": false
          }
        },
        {
          "node": {
            "id": "1108750",
            "accountName": "northwind_creator_9",
            "provider": "INSTAGRAM",
            "followers": 41500,
            "verified": false
          }
        },
        {
          "node": {
            "id": "1084303",
            "accountName": "northwind_creator_3",
            "provider": "INSTAGRAM",
            "followers": 20500,
            "verified": false
          }
        },
        {
          "node": {
            "id": "1094404",
            "accountName": "northwind_creator_4",
            "provider": "TIKTOK",
            "followers": 24000,
            "verified": false
          }
        },
        {
          "node": {
            "id": "1791685",
            "accountName": "northwind_creator_1",
            "provider": "TIKTOK",
            "followers": 13500,
            "verified": false
          }
        }
      ],
      "pageInfo": {
        "hasNextPage": false,
        "endCursor": null
      }
    }
  }
}
```