# items

Query

Search and paginate archived items (social content) for the current workspace.

Available to agents as MCP tool `searchItems` — see [Read tools](/api/v2/docs/mcp/read-tools#search-items).

## Arguments

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `after` | `String` | No | — | Cursor for fetching the next page of results. |
| `customAttributeConditions` | [`[CustomAttributeConditionInput!]`](/api/v2/docs/types/custom-attribute-condition-input) | No | `[]` | Custom attribute filter conditions. |
| `filter` | [`ItemFilterInput`](/api/v2/docs/types/item-filter-input) | No | `{}` | Filter criteria to narrow down results. |
| `first` | `Int` | No | `20` | Number of items to return (page size). |
| `presetId` | `ID` | No | — | Filter preset ID. When provided, sorting, filter, and customAttributeConditions are ignored. Must reference a preset with accessor `media_deck` or `collections`; pass IDs returned by `contentViews` / `collections` queries. Unknown, cross-workspace, or wrong-accessor preset IDs raise a GraphQL error with `extensions.code = "WRONG_VIEW_TYPE_FOR_ITEMS"`. |
| `sorting` | [`[ItemSortingInput!]`](/api/v2/docs/types/item-sorting-input) | No | `[{sortKey: TAKEN_AT, sortOrder: DESC}]` | Sorting instructions to apply to the result set. |

## Returns

A paginated connection of [`Item`](/api/v2/docs/types/item) nodes. See [Pagination](/api/v2/docs/types/pagination) for the connection shape.

## Examples

### List items

Search and paginate the workspace's archived items.

```graphql
query ItemsDefault($first: Int, $after: String) {
  items(first: $first, after: $after) {
    totalCount
    edges {
      node {
        id
        provider
        type
        caption
        takenAt
        originalUrl
        archivePublicUrl
        currentEngagement {
          likes
          comments
          views
          earnedMediaValue
        }
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}
```

Variables:

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

Response — HTTP 200:

```json
{
  "data": {
    "items": {
      "totalCount": 30,
      "edges": [
        {
          "node": {
            "id": "452a119f-393e-5edf-a7f7-f563294f3885",
            "provider": "INSTAGRAM",
            "type": "REEL",
            "caption": "Reel #29 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-30T00:00:00Z",
            "originalUrl": "https://instagram.com/p/docs-item-29",
            "archivePublicUrl": "https://example.com/m/s/45c2aca7-5351-5774-8196-b9346e58a099/6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
            "currentEngagement": {
              "likes": "390",
              "comments": "39",
              "views": "0",
              "earnedMediaValue": "780"
            }
          }
        },
        {
          "node": {
            "id": "d8a538a5-8857-5c0c-b3fb-a2b83c8d2a0b",
            "provider": "YOUTUBE",
            "type": "POST",
            "caption": "Post #28 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-29T00:00:00Z",
            "originalUrl": "https://www.youtube.com/watch?v=docs-item-28",
            "archivePublicUrl": "https://example.com/m/s/037514fd-8da6-5fc4-ab1f-57074132ad11/6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
            "currentEngagement": {
              "likes": "380",
              "comments": "38",
              "views": "0",
              "earnedMediaValue": "760"
            }
          }
        },
        {
          "node": {
            "id": "330cce49-6139-5672-9c61-33fb35bc73e2",
            "provider": "TIKTOK",
            "type": "SHORT",
            "caption": "Short #27 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-28T00:00:00Z",
            "originalUrl": "https://www.tiktok.com/@/video/docs-item-27",
            "archivePublicUrl": "https://example.com/m/s/35e07388-1dc7-5548-b990-0fa5200dd19e/6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
            "currentEngagement": {
              "likes": "370",
              "comments": "37",
              "views": "0",
              "earnedMediaValue": "740"
            }
          }
        },
        {
          "node": {
            "id": "a61d036b-fe79-538c-bbbb-1f97162cab3c",
            "provider": "INSTAGRAM",
            "type": "STORY",
            "caption": "Story #26 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-27T00:00:00Z",
            "originalUrl": null,
            "archivePublicUrl": "https://example.com/m/s/e0d46669-65b0-5b97-ba72-7d6f6a8b3099/6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
            "currentEngagement": {
              "likes": "360",
              "comments": "36",
              "views": "0",
              "earnedMediaValue": "720"
            }
          }
        },
        {
          "node": {
            "id": "de1860a7-2d98-5eda-8977-116583725c74",
            "provider": "YOUTUBE",
            "type": "REEL",
            "caption": "Reel #25 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-26T00:00:00Z",
            "originalUrl": "https://www.youtube.com/watch?v=docs-item-25",
            "archivePublicUrl": "https://example.com/m/s/bd465566-b4a2-508a-a66d-f0ad5b740aed/6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
            "currentEngagement": {
              "likes": "350",
              "comments": "35",
              "views": "0",
              "earnedMediaValue": "700"
            }
          }
        },
        {
          "node": {
            "id": "3870b3f7-2066-56c1-b82e-f7c606c863fa",
            "provider": "TIKTOK",
            "type": "POST",
            "caption": "Post #24 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-25T00:00:00Z",
            "originalUrl": "https://www.tiktok.com/@/video/docs-item-24",
            "archivePublicUrl": "https://example.com/m/s/284c38ea-a14f-51a9-adc4-ec3a2779c5de/6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
            "currentEngagement": {
              "likes": "340",
              "comments": "34",
              "views": "0",
              "earnedMediaValue": "680"
            }
          }
        },
        {
          "node": {
            "id": "2adb5caf-5619-5fc5-b738-ba264cb394a7",
            "provider": "INSTAGRAM",
            "type": "SHORT",
            "caption": "Short #23 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-24T00:00:00Z",
            "originalUrl": null,
            "archivePublicUrl": "https://example.com/m/s/f803ccf8-ebd1-5c7a-8ba4-fc18c1a4d914/6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
            "currentEngagement": {
              "likes": "330",
              "comments": "33",
              "views": "0",
              "earnedMediaValue": "660"
            }
          }
        },
        {
          "node": {
            "id": "5b570218-bf6a-5e05-9389-2f9bfe7f73ce",
            "provider": "YOUTUBE",
            "type": "STORY",
            "caption": "Story #22 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-23T00:00:00Z",
            "originalUrl": "https://www.youtube.com/watch?v=docs-item-22",
            "archivePublicUrl": "https://example.com/m/s/dfdb3836-77f2-5dbc-8ea7-5110924d16c0/6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
            "currentEngagement": {
              "likes": "320",
              "comments": "32",
              "views": "0",
              "earnedMediaValue": "640"
            }
          }
        },
        {
          "node": {
            "id": "24bd35e7-4ae8-546b-bc76-b9cee5e1107f",
            "provider": "TIKTOK",
            "type": "REEL",
            "caption": "Reel #21 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-22T00:00:00Z",
            "originalUrl": "https://www.tiktok.com/@/video/docs-item-21",
            "archivePublicUrl": "https://example.com/m/s/4b328433-86dc-593d-918a-d435836c868d/6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
            "currentEngagement": {
              "likes": "310",
              "comments": "31",
              "views": "0",
              "earnedMediaValue": "620"
            }
          }
        },
        {
          "node": {
            "id": "5503f877-fd11-5373-b372-ce4738980780",
            "provider": "INSTAGRAM",
            "type": "POST",
            "caption": "Post #20 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-21T00:00:00Z",
            "originalUrl": "https://instagram.com/p/docs-item-20",
            "archivePublicUrl": "https://example.com/m/s/90f4b06d-bdca-5b74-871a-7c879309c9b9/6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
            "currentEngagement": {
              "likes": "300",
              "comments": "30",
              "views": "0",
              "earnedMediaValue": "600"
            }
          }
        }
      ],
      "pageInfo": {
        "hasNextPage": true,
        "endCursor": "Z2lkOi8vYXJjaGl2ZS9JdGVtLzU1MDNmODc3LWZkMTEtNTM3My1iMzcyLWNlNDczODk4MDc4MA=="
      }
    }
  }
}
```

### Error — unknown items preset

An items query with an unknown presetId returns a GraphQL error.

```graphql
query ItemsErrorUnknownPreset($presetId: ID, $first: Int) {
  items(presetId: $presetId, first: $first) {
    totalCount
    edges {
      node {
        id
      }
    }
  }
}
```

Variables:

```json
{
  "presetId": "00000000-0000-0000-0000-000000000000",
  "first": 5
}
```

Response — HTTP 200:

```json
{
  "errors": [
    {
      "message": "Preset \"00000000-0000-0000-0000-000000000000\" was not found in the current workspace.",
      "extensions": {
        "code": "WRONG_VIEW_TYPE_FOR_ITEMS",
        "allowedAccessors": [
          "media_deck",
          "collections"
        ]
      },
      "locations": [
        {
          "line": 2,
          "column": 3
        }
      ],
      "path": [
        "items"
      ]
    }
  ],
  "data": null
}
```

### Filter items by custom attribute

Return items whose sentiment custom attribute equals positive.

```graphql
query ItemsCustomAttributeCondition($customAttributeConditions: [CustomAttributeConditionInput!], $first: Int) {
  items(customAttributeConditions: $customAttributeConditions, first: $first) {
    totalCount
    edges {
      node {
        id
        caption
        customAttributes
      }
    }
  }
}
```

Variables:

```json
{
  "customAttributeConditions": [
    {
      "field": "sentiment",
      "operator": "IS",
      "type": "SINGLE_SELECT_V2",
      "value": "positive"
    }
  ],
  "first": 20
}
```

Response — HTTP 200:

```json
{
  "data": {
    "items": {
      "totalCount": 5,
      "edges": [
        {
          "node": {
            "id": "852bb4df-4e3c-519e-9318-7a950148e349",
            "caption": "Post #4 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "customAttributes": {
              "sentiment": "positive"
            }
          }
        },
        {
          "node": {
            "id": "e1bf0fd2-53cc-536d-9168-35635aa64fd8",
            "caption": "Short #3 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "customAttributes": {
              "sentiment": "positive"
            }
          }
        },
        {
          "node": {
            "id": "a78ec1f9-5c4b-5c8a-b3b1-e028e575b606",
            "caption": "Story #2 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "customAttributes": {
              "sentiment": "positive",
              "collections": [
                "34714af3-fb12-5d72-8094-c94ce02be1fa"
              ]
            }
          }
        },
        {
          "node": {
            "id": "99bb982f-563c-5cd7-9475-2798be58f881",
            "caption": "Reel #1 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "customAttributes": {
              "sentiment": "positive",
              "collections": [
                "34714af3-fb12-5d72-8094-c94ce02be1fa"
              ]
            }
          }
        },
        {
          "node": {
            "id": "63c311c4-32f0-5d8c-ac02-78b160f2290a",
            "caption": "Post #0 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "customAttributes": {
              "sentiment": "positive",
              "collections": [
                "34714af3-fb12-5d72-8094-c94ce02be1fa"
              ]
            }
          }
        }
      ]
    }
  }
}
```

### Filter items by date range

Return items posted within a takenAt window.

```graphql
query ItemsFilterDateRange($filter: ItemFilterInput, $first: Int) {
  items(filter: $filter, first: $first) {
    totalCount
    edges {
      node {
        id
        caption
        takenAt
      }
    }
  }
}
```

Variables:

```json
{
  "filter": {
    "takenAt": {
      "from": "2024-10-01T00:00:00Z",
      "to": "2024-12-31T00:00:00Z"
    }
  },
  "first": 20
}
```

Response — HTTP 200:

```json
{
  "data": {
    "items": {
      "totalCount": 30,
      "edges": [
        {
          "node": {
            "id": "452a119f-393e-5edf-a7f7-f563294f3885",
            "caption": "Reel #29 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-30T00:00:00Z"
          }
        },
        {
          "node": {
            "id": "d8a538a5-8857-5c0c-b3fb-a2b83c8d2a0b",
            "caption": "Post #28 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-29T00:00:00Z"
          }
        },
        {
          "node": {
            "id": "330cce49-6139-5672-9c61-33fb35bc73e2",
            "caption": "Short #27 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-28T00:00:00Z"
          }
        },
        {
          "node": {
            "id": "a61d036b-fe79-538c-bbbb-1f97162cab3c",
            "caption": "Story #26 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-27T00:00:00Z"
          }
        },
        {
          "node": {
            "id": "de1860a7-2d98-5eda-8977-116583725c74",
            "caption": "Reel #25 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-26T00:00:00Z"
          }
        },
        {
          "node": {
            "id": "3870b3f7-2066-56c1-b82e-f7c606c863fa",
            "caption": "Post #24 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-25T00:00:00Z"
          }
        },
        {
          "node": {
            "id": "2adb5caf-5619-5fc5-b738-ba264cb394a7",
            "caption": "Short #23 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-24T00:00:00Z"
          }
        },
        {
          "node": {
            "id": "5b570218-bf6a-5e05-9389-2f9bfe7f73ce",
            "caption": "Story #22 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-23T00:00:00Z"
          }
        },
        {
          "node": {
            "id": "24bd35e7-4ae8-546b-bc76-b9cee5e1107f",
            "caption": "Reel #21 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-22T00:00:00Z"
          }
        },
        {
          "node": {
            "id": "5503f877-fd11-5373-b372-ce4738980780",
            "caption": "Post #20 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-21T00:00:00Z"
          }
        },
        {
          "node": {
            "id": "dbc66518-991e-5f66-9b93-f680af733f6e",
            "caption": "Short #19 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-20T00:00:00Z"
          }
        },
        {
          "node": {
            "id": "ec78fe4c-a457-5446-b77b-b739e526253e",
            "caption": "Story #18 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-19T00:00:00Z"
          }
        },
        {
          "node": {
            "id": "28aa71e5-7d0a-5edc-b11d-545f28ad32e7",
            "caption": "Reel #17 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-18T00:00:00Z"
          }
        },
        {
          "node": {
            "id": "eef04e09-52e4-5eae-8b7a-b07b87e35c1a",
            "caption": "Post #16 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-17T00:00:00Z"
          }
        },
        {
          "node": {
            "id": "259f36f6-b92b-55ff-b065-40906bfc2826",
            "caption": "Short #15 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-16T00:00:00Z"
          }
        },
        {
          "node": {
            "id": "9d3b36d5-f71d-5283-abf9-6f3a1415ac9c",
            "caption": "Story #14 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-15T00:00:00Z"
          }
        },
        {
          "node": {
            "id": "1ee18054-a7dc-5951-9711-58b254138bae",
            "caption": "Reel #13 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-14T00:00:00Z"
          }
        },
        {
          "node": {
            "id": "be093358-c18b-5a9b-af8d-7e39d2b1e39c",
            "caption": "Post #12 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-13T00:00:00Z"
          }
        },
        {
          "node": {
            "id": "f81eb89a-9d29-5f25-9d73-4f0e32bb5cab",
            "caption": "Short #11 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-12T00:00:00Z"
          }
        },
        {
          "node": {
            "id": "de3d94b7-2a6e-5b6d-b726-9e4c38279a61",
            "caption": "Story #10 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "takenAt": "2024-11-11T00:00:00Z"
          }
        }
      ]
    }
  }
}
```

### Filter items by engagement

Return items with at least a minimum number of likes.

```graphql
query ItemsFilterEngagementRange($filter: ItemFilterInput, $first: Int) {
  items(filter: $filter, first: $first) {
    totalCount
    edges {
      node {
        id
        caption
        currentEngagement {
          likes
          views
        }
      }
    }
  }
}
```

Variables:

```json
{
  "filter": {
    "engagement": [
      {
        "field": "LIKE_COUNT",
        "range": {
          "from": 100
        }
      }
    ]
  },
  "first": 20
}
```

Response — HTTP 200:

```json
{
  "data": {
    "items": {
      "totalCount": 30,
      "edges": [
        {
          "node": {
            "id": "452a119f-393e-5edf-a7f7-f563294f3885",
            "caption": "Reel #29 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "390",
              "views": "0"
            }
          }
        },
        {
          "node": {
            "id": "d8a538a5-8857-5c0c-b3fb-a2b83c8d2a0b",
            "caption": "Post #28 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "380",
              "views": "0"
            }
          }
        },
        {
          "node": {
            "id": "330cce49-6139-5672-9c61-33fb35bc73e2",
            "caption": "Short #27 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "370",
              "views": "0"
            }
          }
        },
        {
          "node": {
            "id": "a61d036b-fe79-538c-bbbb-1f97162cab3c",
            "caption": "Story #26 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "360",
              "views": "0"
            }
          }
        },
        {
          "node": {
            "id": "de1860a7-2d98-5eda-8977-116583725c74",
            "caption": "Reel #25 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "350",
              "views": "0"
            }
          }
        },
        {
          "node": {
            "id": "3870b3f7-2066-56c1-b82e-f7c606c863fa",
            "caption": "Post #24 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "340",
              "views": "0"
            }
          }
        },
        {
          "node": {
            "id": "2adb5caf-5619-5fc5-b738-ba264cb394a7",
            "caption": "Short #23 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "330",
              "views": "0"
            }
          }
        },
        {
          "node": {
            "id": "5b570218-bf6a-5e05-9389-2f9bfe7f73ce",
            "caption": "Story #22 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "320",
              "views": "0"
            }
          }
        },
        {
          "node": {
            "id": "24bd35e7-4ae8-546b-bc76-b9cee5e1107f",
            "caption": "Reel #21 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "310",
              "views": "0"
            }
          }
        },
        {
          "node": {
            "id": "5503f877-fd11-5373-b372-ce4738980780",
            "caption": "Post #20 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "300",
              "views": "0"
            }
          }
        },
        {
          "node": {
            "id": "dbc66518-991e-5f66-9b93-f680af733f6e",
            "caption": "Short #19 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "290",
              "views": "0"
            }
          }
        },
        {
          "node": {
            "id": "ec78fe4c-a457-5446-b77b-b739e526253e",
            "caption": "Story #18 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "280",
              "views": "0"
            }
          }
        },
        {
          "node": {
            "id": "28aa71e5-7d0a-5edc-b11d-545f28ad32e7",
            "caption": "Reel #17 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "270",
              "views": "0"
            }
          }
        },
        {
          "node": {
            "id": "eef04e09-52e4-5eae-8b7a-b07b87e35c1a",
            "caption": "Post #16 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "260",
              "views": "0"
            }
          }
        },
        {
          "node": {
            "id": "259f36f6-b92b-55ff-b065-40906bfc2826",
            "caption": "Short #15 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "250",
              "views": "0"
            }
          }
        },
        {
          "node": {
            "id": "9d3b36d5-f71d-5283-abf9-6f3a1415ac9c",
            "caption": "Story #14 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "240",
              "views": "0"
            }
          }
        },
        {
          "node": {
            "id": "1ee18054-a7dc-5951-9711-58b254138bae",
            "caption": "Reel #13 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "230",
              "views": "0"
            }
          }
        },
        {
          "node": {
            "id": "be093358-c18b-5a9b-af8d-7e39d2b1e39c",
            "caption": "Post #12 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "220",
              "views": "0"
            }
          }
        },
        {
          "node": {
            "id": "f81eb89a-9d29-5f25-9d73-4f0e32bb5cab",
            "caption": "Short #11 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "210",
              "views": "0"
            }
          }
        },
        {
          "node": {
            "id": "de3d94b7-2a6e-5b6d-b726-9e4c38279a61",
            "caption": "Story #10 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "likes": "200",
              "views": "0"
            }
          }
        }
      ]
    }
  }
}
```

### Sort items by earned media value

Order items by earned media value, highest first.

```graphql
query ItemsSorting($sorting: [ItemSortingInput!], $first: Int) {
  items(sorting: $sorting, first: $first) {
    totalCount
    edges {
      node {
        id
        caption
        currentEngagement {
          earnedMediaValue
        }
      }
    }
  }
}
```

Variables:

```json
{
  "sorting": [
    {
      "sortKey": "EARNED_MEDIA_VALUE",
      "sortOrder": "DESC"
    }
  ],
  "first": 20
}
```

Response — HTTP 200:

```json
{
  "data": {
    "items": {
      "totalCount": 30,
      "edges": [
        {
          "node": {
            "id": "452a119f-393e-5edf-a7f7-f563294f3885",
            "caption": "Reel #29 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "780"
            }
          }
        },
        {
          "node": {
            "id": "d8a538a5-8857-5c0c-b3fb-a2b83c8d2a0b",
            "caption": "Post #28 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "760"
            }
          }
        },
        {
          "node": {
            "id": "330cce49-6139-5672-9c61-33fb35bc73e2",
            "caption": "Short #27 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "740"
            }
          }
        },
        {
          "node": {
            "id": "a61d036b-fe79-538c-bbbb-1f97162cab3c",
            "caption": "Story #26 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "720"
            }
          }
        },
        {
          "node": {
            "id": "de1860a7-2d98-5eda-8977-116583725c74",
            "caption": "Reel #25 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "700"
            }
          }
        },
        {
          "node": {
            "id": "3870b3f7-2066-56c1-b82e-f7c606c863fa",
            "caption": "Post #24 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "680"
            }
          }
        },
        {
          "node": {
            "id": "2adb5caf-5619-5fc5-b738-ba264cb394a7",
            "caption": "Short #23 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "660"
            }
          }
        },
        {
          "node": {
            "id": "5b570218-bf6a-5e05-9389-2f9bfe7f73ce",
            "caption": "Story #22 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "640"
            }
          }
        },
        {
          "node": {
            "id": "24bd35e7-4ae8-546b-bc76-b9cee5e1107f",
            "caption": "Reel #21 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "620"
            }
          }
        },
        {
          "node": {
            "id": "5503f877-fd11-5373-b372-ce4738980780",
            "caption": "Post #20 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "600"
            }
          }
        },
        {
          "node": {
            "id": "dbc66518-991e-5f66-9b93-f680af733f6e",
            "caption": "Short #19 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "580"
            }
          }
        },
        {
          "node": {
            "id": "ec78fe4c-a457-5446-b77b-b739e526253e",
            "caption": "Story #18 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "560"
            }
          }
        },
        {
          "node": {
            "id": "28aa71e5-7d0a-5edc-b11d-545f28ad32e7",
            "caption": "Reel #17 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "540"
            }
          }
        },
        {
          "node": {
            "id": "eef04e09-52e4-5eae-8b7a-b07b87e35c1a",
            "caption": "Post #16 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "520"
            }
          }
        },
        {
          "node": {
            "id": "259f36f6-b92b-55ff-b065-40906bfc2826",
            "caption": "Short #15 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "500"
            }
          }
        },
        {
          "node": {
            "id": "9d3b36d5-f71d-5283-abf9-6f3a1415ac9c",
            "caption": "Story #14 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "480"
            }
          }
        },
        {
          "node": {
            "id": "1ee18054-a7dc-5951-9711-58b254138bae",
            "caption": "Reel #13 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "460"
            }
          }
        },
        {
          "node": {
            "id": "be093358-c18b-5a9b-af8d-7e39d2b1e39c",
            "caption": "Post #12 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "440"
            }
          }
        },
        {
          "node": {
            "id": "f81eb89a-9d29-5f25-9d73-4f0e32bb5cab",
            "caption": "Short #11 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "420"
            }
          }
        },
        {
          "node": {
            "id": "de3d94b7-2a6e-5b6d-b726-9e4c38279a61",
            "caption": "Story #10 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals",
            "currentEngagement": {
              "earnedMediaValue": "400"
            }
          }
        }
      ]
    }
  }
}
```

### Semantic search over item captions

Fuzzy-match items by caption text with superSearch.

```graphql
query ItemsSuperSearch($filter: ItemFilterInput, $first: Int) {
  items(filter: $filter, first: $first) {
    totalCount
    edges {
      node {
        id
        caption
      }
    }
  }
}
```

Variables:

```json
{
  "filter": {
    "superSearch": {
      "mode": "FUZZY_CAPTION",
      "searchQuery": "Northwind Botanicals"
    }
  },
  "first": 20
}
```

Response — HTTP 200:

```json
{
  "data": {
    "items": {
      "totalCount": 30,
      "edges": [
        {
          "node": {
            "id": "0ea0f5a3-257d-580f-ba63-9b693166eecd",
            "caption": "Reel #9 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        },
        {
          "node": {
            "id": "1ee18054-a7dc-5951-9711-58b254138bae",
            "caption": "Reel #13 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        },
        {
          "node": {
            "id": "24bd35e7-4ae8-546b-bc76-b9cee5e1107f",
            "caption": "Reel #21 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        },
        {
          "node": {
            "id": "259f36f6-b92b-55ff-b065-40906bfc2826",
            "caption": "Short #15 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        },
        {
          "node": {
            "id": "28aa71e5-7d0a-5edc-b11d-545f28ad32e7",
            "caption": "Reel #17 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        },
        {
          "node": {
            "id": "2adb5caf-5619-5fc5-b738-ba264cb394a7",
            "caption": "Short #23 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        },
        {
          "node": {
            "id": "330cce49-6139-5672-9c61-33fb35bc73e2",
            "caption": "Short #27 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        },
        {
          "node": {
            "id": "3870b3f7-2066-56c1-b82e-f7c606c863fa",
            "caption": "Post #24 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        },
        {
          "node": {
            "id": "4083ca4a-13e4-54d1-a116-ba4af73cc59b",
            "caption": "Story #6 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        },
        {
          "node": {
            "id": "452a119f-393e-5edf-a7f7-f563294f3885",
            "caption": "Reel #29 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        },
        {
          "node": {
            "id": "5503f877-fd11-5373-b372-ce4738980780",
            "caption": "Post #20 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        },
        {
          "node": {
            "id": "5b570218-bf6a-5e05-9389-2f9bfe7f73ce",
            "caption": "Story #22 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        },
        {
          "node": {
            "id": "63c311c4-32f0-5d8c-ac02-78b160f2290a",
            "caption": "Post #0 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        },
        {
          "node": {
            "id": "76a4c7a9-6abd-5392-9869-83b006c9c4a6",
            "caption": "Short #7 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        },
        {
          "node": {
            "id": "7f0da362-a674-5057-95ca-4df2380e63e3",
            "caption": "Post #8 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        },
        {
          "node": {
            "id": "80ca1b0c-5fc2-583e-acbc-6a3e02e05e9e",
            "caption": "Reel #5 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        },
        {
          "node": {
            "id": "852bb4df-4e3c-519e-9318-7a950148e349",
            "caption": "Post #4 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        },
        {
          "node": {
            "id": "99bb982f-563c-5cd7-9475-2798be58f881",
            "caption": "Reel #1 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        },
        {
          "node": {
            "id": "9d3b36d5-f71d-5283-abf9-6f3a1415ac9c",
            "caption": "Story #14 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        },
        {
          "node": {
            "id": "a61d036b-fe79-538c-bbbb-1f97162cab3c",
            "caption": "Story #26 from Northwind Botanicals #northwindbotanicals #plantcare #growwithnorthwind @northwindbotanicals"
          }
        }
      ]
    }
  }
}
```