YouTube: Search Videos¶
Plugin ID: eca_youtube_search_videos
Available since: 1.0.0
Searches YouTube videos with advanced filtering options including channel, date range, duration, and result ordering. Returns video metadata for matching results.
Fields¶
Authentication Type— config key:auth_type-
Choose between API Client (OAuth2) or Service Account authentication.
Type:
select· Required: yes · Default:api_clientAllowed values:
api_client,service_account Authentication Source— config key:auth_from-
Choose whether to select authentication directly or use a token for dynamic selection.
Type:
select· Required: yes · Default:directAllowed values:
direct,token API Client— config key:api_client_id-
Search and select an API Client for OAuth2 authentication.
Type:
textfield· Required: no · Default: empty string Service Account— config key:service_account_id-
Search and select a Service Account for server-to-server authentication.
Type:
textfield· Required: no · Default: empty string Client ID from Token— config key:auth_client_from_token-
Token that resolves to a client ID (e.g., [user:field_google_client_id]). The token should contain just the client ID, not the auth type prefix.
This field supports tokens.Type:
textfield· Required: no · Default: empty string Search Query— config key:search_query-
Keywords to search for. Leave empty to search all videos (if channel specified).
This field supports tokens.Type:
textfield· Required: no · Default: empty string Channel ID— config key:channel_id-
Optional channel ID to limit search to specific channel (e.g., UCBa659QWEk1AI4Tg--mrJ2A).
This field supports tokens.Type:
textfield· Required: no · Default: empty string Published After— config key:published_after-
Search for videos published after this date. Supports multiple formats: For date range fields use [entity:field_date_range:start_date], for Smart Date fields use [entity:field_smart_date:value], for regular datetime fields use [entity:field_date:date]. Also supports string formats like "2023-01-01", "2023-01-01T00:00:00Z", timestamps, and Drupal field formats.
This field supports tokens.Type:
textfield· Required: no · Default: empty string Published Before— config key:published_before-
Search for videos published before this date. Supports multiple formats: For date range fields use [entity:field_date_range:end_date], for Smart Date fields use [entity:field_smart_date:end_value], for regular datetime fields use [entity:field_date:date]. Also supports string formats like "2024-01-01", "2024-01-01T00:00:00Z", timestamps, and Drupal field formats.
This field supports tokens.Type:
textfield· Required: no · Default: empty string Order Results By— config key:order-
How to order the search results.
Type:
select· Required: no · Default:relevanceAllowed values:
relevance,date,rating,viewCount,title Duration Filter— config key:duration-
Filter videos by duration.
Type:
select· Required: no · Default: empty stringAllowed values:
'',short,medium,long Maximum Results— config key:max_results-
Maximum number of results to return (1-50).
Type:
number· Required: yes · Default:10 Search Results Token Name— config key:search_token_name-
Optional token name to store search results. Accessible as [token_name:results:0:title], [token_name:total_results], etc.
This field supports tokens.Type:
textfield· Required: no · Default: empty string