YouTube General Search API (V1)
justoneapi_get_api_youtube_search_v1Search YouTube videos by keyword with optional language, upload-date, duration, and sort filters, or continue with a pagination token. Use it to discover public videos or browse additional result pages. Uses the caller's OpenAny gateway credentials. Charges and authorization are determined by the gateway.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Optional IETF language tag for localized results, such as en-US. Leave empty to use the default language. | |
| sortBy | No | Sort order for search results. Available Values: - `relevance`: Sort by relevance - `uploadDate`: Sort by upload date - `viewCount`: Sort by view count - `rating`: Sort by rating | |
| keyword | No | Search term. Required for the first page; leave empty when using nextToken. | |
| duration | No | Video-duration filter. Available Values: - `all`: No duration limit - `short`: Short videos under 4 minutes - `medium`: Medium videos from 4 to 20 minutes - `long`: Long videos over 20 minutes | |
| nextToken | No | Pagination token returned by the previous response. When provided, the keyword and filter parameters are ignored; very long tokens may exceed GET URL limits. | |
| uploadDate | No | Upload-date filter. Available Values: - `all`: No upload-date limit - `lastHour`: Uploaded within the last hour - `today`: Uploaded today - `thisWeek`: Uploaded this week - `thisMonth`: Uploaded this month - `thisYear`: Uploaded this year |