YouTube tools

YouTubeyoutube_category_search

YouTube Search

Find videos, Shorts and channels by keyword. Bring structured YouTube results into your agent or app.

Start with your agent

Claude CodeCodexCursor

Download and install the dedicated Mouter Skill for “YouTube Search”: https://mouter.ai/skills/youtube_category_search.zip

Pricing

How credits work

0.01 credits per call

Each additional page is billed as a separate call.

Usage example

Agent

Example input

Use youtube_category_search to find YouTube videos for "Kyoto travel guide". Return the first page with titles or names, source links and counts as displayed. Confirm the inputs and cost before running.

Example output

Here are the first 3 videos for “Kyoto travel guide”:

  1. Kyoto in a day: a walking guideKyoto Travel Notes · 24K views · 12:34 · 2 weeks agoyoutube.com/watch?v=<VIDEO_ID_1>
  2. Temples and tea houses: slow travel in KyotoSlow Journeys · 8.1K views · 18:05 · 1 month agoyoutube.com/watch?v=<VIDEO_ID_2>
  3. Where to eat in Kyoto: a neighborhood guideTabi Diary · 3.2K views · 9:48 · 3 months agoyoutube.com/watch?v=<VIDEO_ID_3>

Counts and dates are shown as YouTube displays them. No more pages.

Continue this example

For the first batch, omit cursor. When pagination.has_more indicates more results and pagination.next_cursor is present, pass the returned pagination.next_cursor as cursor in the next call. Keep the original identifiers, filters and ordering unchanged. Each request retrieves one batch. Illustrative requests and response fragment; no calls are executed.

1. Initial request

{
  "name": "youtube_category_search",
  "arguments": {
    "query": "Kyoto travel guide",
    "kind": "video"
  }
}

2. Returned continuation

{
  "pagination": {
    "next_cursor": "<NEXT_CURSOR>",
    "has_more": true
  }
}

3. Follow-up request

{
  "name": "youtube_category_search",
  "arguments": {
    "query": "Kyoto travel guide",
    "kind": "video",
    "cursor": "<NEXT_CURSOR>"
  }
}

FAQ

Can I search videos, Shorts and channels?

Yes. Set kind to video, short or channel. The default is video. Each mode returns fields suited to that kind of result.

Does “category” mean a YouTube topic category?

Here, the tool’s name refers to result types: videos, Shorts and channels. The published input schema selects these with kind and does not expose a topic-category ID.

How do I retrieve the next page?

Each call returns one page. When pagination.has_more is true and next_cursor is present, pass it as cursor in the next request with the same search settings. Each additional call is a separate request.

Are view and subscriber counts exact numbers?

These fields preserve YouTube’s displayed text, such as “24K views”. Keep that text when reporting results; it should not be treated as an exact count. Publication times are also preserved as displayed text.

How much does a search cost?

The rate per call is listed in the Pricing section. Each search returns one page, and each additional page is a separate call. Final charges use the executing account’s rate.