---
schema_version: "1"
id: 003f6894fd8faba1c24f780f04cdb56b77855f6e341c853e4bff5de283d7acae
title: Search for Content in Your Marketing Cloud Next Content Workspace
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/mc-core/guide/mc-manage-content/mc-manage-content-search.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud-growth/guide/mc-manage-content-search.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 40a69ef5a15c6ff1364f812a6d0b0336bec79398413445031229d8078106cdb2
products:
  - Marketing Cloud Next
  - Marketing Cloud
---
# Search for Content in Your Marketing Cloud Next Content Workspace

Use the [CMS Search](https://developer.salesforce.com/docs/atlas.en-us.chatterapi.meta/chatterapi/connect_resources_cms_items_search.htm) endpoints in Connect API to search for content in your marketing content workspace.

## Step 1: Get a Workspace ID

First, find the ID of the content workspace or folder that you want to search. If you know the workspace ID, skip this step. Otherwise, retrieve a list of workspaces by issuing a GET request to the `/services/data/{apiVersion}/connect/cms/spaces` endpoint.

```json
GET /services/data/{apiVersion}/connect/cms/spaces HTTP/1.1
Host: {subdomain}.my.salesforce.com
Authorization: Bearer YOUR_BEARER_TOKEN
```

If the request is successful, the response includes a list of workspaces.

```json
{
  "spaces": [
    {
      "apiName": "MCN_Workspace",
      "id": "0ZuQZ0000004YSv0AM",
      "name": "MCN Workspace",
      "spaceType": {
        "apiName": "marketing"
      }
    }
  ]
}
```

Copy the `id` value of the workspace to use in your search query.

## Step 2: Search for Content

Issue a GET request to the `/services/data/{apiVersion}/connect/cms/items/search` endpoint. The request can include the query parameters listed in this table.

| Query Parameter           | Data Type | Description                                                                                                                             |
| ------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `contentSpaceOrFolderIds` | string    | Required. The ID of the workspace or folder to search.                                                                                  |
| `contentTypeFQN`          | string    | The fully qualified name of a content type to filter by in the search.                                                                  |
| `languages`               | string    | A locale code for filtering the results. Provide a locale code, such as `en_CA` or `es_MX`, or specify `All` to retrieve all languages. |
| `page`                    | int       | The page number of results to return. The first page of results is page `0`.                                                            |
| `pageSize`                | int       | The number of results to return per page. The maximum value is 250. The default value is `25`.                                          |
| `queryTerm`               | string    | The search term. Use `*` as a wildcard to return all content.                                                                           |
| `scope`                   | string    | The search scope. Use `All` to search across all fields, or `TitleOnly` to search titles only.                                          |

Include the workspace ID in the `contentSpaceOrFolderIds` query parameter.

```json
GET /services/data/{apiVersion}/connect/cms/items/search?queryTerm=*&scope=All&pageSize=250&contentSpaceOrFolderIds=0ZuQZ0000004YSv0AM HTTP/1.1
Host: {subdomain}.my.salesforce.com
Authorization: Bearer YOUR_BEARER_TOKEN
```

If the request is successful, the response includes a list of content items.

```json
{
  "count": 49,
  "currentPageUri": "/services/data/v68.0/connect/cms/items/search?page=0&pageSize=250",
  "nextPageUri": "/services/data/v68.0/connect/cms/items/search?page=1&pageSize=250",
  "items": [
    {
      "id": "9PsQZ00000072oH0AQ",
      "contentKey": "MCNUSLTYAES5CLRKYWXFUXDXW2BM",
      "title": "Email_20260323_145319",
      "status": "Draft",
      "contentType": {
        "developerName": "sfdc_cms__email",
        "label": "Email"
      },
      "managedContentId": "20YQZ0000007G3F2AU",
      "managedContentSpaceId": "0ZuQZ0000003xWc0AI"
    }
  ]
}
```

The response includes the properties in this table.

| Property         | Data Type | Description                                               |
| ---------------- | --------- | --------------------------------------------------------- |
| `count`          | int       | The total number of results for the query.                |
| `currentPageUri` | string    | The address of the current page of results                |
| `nextPageUri`    | string    | The address of the next page of results, if one exists.   |
| `items`          | int       | An array of content items that match the search criteria. |

Each content item includes a `contentKey` that you can use to retrieve the full content details.

## Filter Search Results

You can filter search results by content type or language.

### Filter by Content Type

To return only emails or email templates, include the `contentTypeFQN` query parameter. This example returns only content with the content type `sfdc_cms__email`.

```json
GET /services/data/{apiVersion}/connect/cms/items/search?queryTerm=*&scope=All&pageSize=250&contentSpaceOrFolderIds=0ZuQZ0000004YSv0AM&contentTypeFQN=sfdc_cms__email HTTP/1.1
Host: {subdomain}.my.salesforce.com
Authorization: Bearer YOUR_BEARER_TOKEN
```

### Filter by Language

To return content in a specific language, include the `languages` query parameter. This example returns only items with the `en_US` locale code.

```json
GET /services/data/{apiVersion}/connect/cms/items/search?queryTerm=*&scope=All&pageSize=250&contentSpaceOrFolderIds=0ZuQZ0000004YSv0AM&languages=en_US HTTP/1.1
Host: {subdomain}.my.salesforce.com
Authorization: Bearer YOUR_BEARER_TOKEN
```

## See Also

- API Reference: [Search CMS Content](/docs/marketing/marketing-cloud-growth/references/mc-next-cms-resources?meta=searchContent)