Get YouTube search terms (OAuth)
get_search_termsRetrieve the search terms viewers typed before watching your videos, with views and watch time per term, to inform titles, descriptions and tags. Filter by date range or specific video.
Instructions
The YouTube search terms viewers typed before watching your videos, with views and watch time per term.
Useful for titles, descriptions and tags. Requires OAuth.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_search_terms"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | When no dates are given: the last N days ending today. | |
| limit | No | How many terms, 1-25 (the API's maximum). | |
| end_date | No | End date YYYY-MM-DD, inclusive. | |
| video_id | No | Only searches that led to this video. Omit for the whole channel. | |
| start_date | No | Start date YYYY-MM-DD, inclusive. Omit both dates to use `days`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||