> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# appmixer.google.youtube.FindVideos

- Component: `appmixer.google.youtube.FindVideos`
- Kind: Action
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.google.youtube 1.3.8](https://connectors.appmixer.com/connector/appmixer.google.youtube/1.3.8.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.google.youtube/1.3.8/component/appmixer.google.youtube.FindVideos>

Search for YouTube videos based on user search criteria.

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Channel ID (`channelId`) | text | The unique ID of a specific Channel to search for videos within. |
| Search Term (`searchTerm`) | text | Enter search term for video. |
| Safe Search (`safeSearch`) | select | Enter safe search mode. |
| Video Embeddable (`videoEmbeddable`) | select | Enter video embeddable mode. |
| Output Type (`outputType`) | select | Choose whether you want to receive the result set as one complete list, or one item at a time or stream the items to a file. For large datasets, streaming the rows to a file is the most efficient method. |
| Limit (`limit`) | number | The number of results you want to retrieve. |

## Output ports

### Port `out`

Variables are loaded dynamically from `/component/appmixer/google/youtube/FindVideos?outPort=out`.

### Port `notFound`

| Field | Type | Description |
| --- | --- | --- |
| YouTube Search Term (`youtubeSearchTerm`) | string | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.google.youtube.FindVideos",
  "author": "Harsha Surisetty <harsha@client.io>",
  "description": "Search for YouTube videos based on user search criteria.",
  "version": "1.0.0",
  "auth": {
    "service": "appmixer:google",
    "scope": [
      "https://www.googleapis.com/auth/youtube.force-ssl"
    ]
  },
  "quota": {
    "manager": "appmixer:google:youtube",
    "maxWait": 5000,
    "resources": "FindVideos",
    "scope": {
      "userId": "{{userId}}"
    }
  },
  "inPorts": [
    {
      "name": "in",
      "inspector": {
        "inputs": {
          "channelId": {
            "type": "text",
            "label": "Channel ID",
            "index": 1,
            "tooltip": "The unique ID of a specific Channel to search for videos within."
          },
          "searchTerm": {
            "type": "text",
            "label": "Search Term",
            "index": 2,
            "tooltip": "Enter search term for video."
          },
          "safeSearch": {
            "type": "select",
            "options": [
              {
                "content": "None",
                "value": "none"
              },
              {
                "content": "Moderate",
                "value": "moderate"
              },
              {
                "content": "Strict",
                "value": "strict"
              }
            ],
            "label": "Safe Search",
            "index": 3,
            "tooltip": "Enter safe search mode."
          },
          "videoEmbeddable": {
            "type": "select",
            "options": [
              {
                "content": "Any",
                "value": "any"
              },
              {
                "content": "True",
                "value": "true"
              }
            ],
            "label": "Video Embeddable",
            "index": 4,
            "defaultValue": "any",
            "tooltip": "Enter video embeddable mode."
          },
          "outputType": {
            "type": "select",
            "label": "Output Type",
            "index": 5,
            "defaultValue": "items",
            "tooltip": "Choose whether you want to receive the result set as one complete list, or one item at a time or stream the items to a file. For large datasets, streaming the rows to a file is the most efficient method.",
            "options": [
              {
                "label": "All at once",
                "value": "items"
              },
              {
                "label": "One at a time",
                "value": "item"
              },
              {
                "label": "File",
                "value": "file"
              }
            ]
          },
          "limit": {
            "type": "number",
            "label": "Limit",
            "index": 6,
            "tooltip": "The number of results you want to retrieve.",
            "defaultValue": 50
          }
        }
      },
      "schema": {
        "type": "object",
        "properties": {
          "channelId": {
            "type": "string"
          },
          "searchTerm": {
            "type": "string"
          },
          "safeSearch": {
            "type": "string"
          },
          "videoEmbeddable": {
            "type": "string"
          },
          "outputType": {
            "type": "string"
          },
          "limit": {
            "type": "number"
          }
        },
        "required": [
          "searchTerm"
        ]
      }
    }
  ],
  "outPorts": [
    {
      "name": "out",
      "source": {
        "url": "/component/appmixer/google/youtube/FindVideos?outPort=out",
        "data": {
          "properties": {
            "generateOutputPortOptions": true
          },
          "messages": {
            "in/outputType": "inputs/in/outputType",
            "in/channel": "inputs/in/channel",
            "in/searchTerm": "inputs/in/searchTerm",
            "in/safeSearch": "inputs/in/safeSearch",
            "in/videoEmbeddable": "inputs/in/videoEmbeddable",
            "in/limit": "inputs/in/limit"
          }
        }
      }
    },
    {
      "name": "notFound",
      "options": [
        {
          "label": "YouTube Search Term",
          "value": "youtubeSearchTerm",
          "schema": {
            "type": "string",
            "example": "sourdough bread recipe"
          }
        }
      ]
    }
  ],
  "icon": "(data URI omitted)"
}
```
