serp.youtube

Search YouTube: pay per use, no API key

Use SerpApi from Claude, Claude Code, Cursor, ChatGPT, and other agents through one Cralo balance.

Return YouTube video results with channels, view counts, durations, and links through SerpApi. An empty videos list is a successful no-match, not an error.

Price and execution

Price: $0.025
Pricing model: Fixed price per successful call
Execution class: fast

Limits

No additional limits are published for this tool.

Parameters

Fields serp.youtube accepts as JSON input.

limitintegerOptional
Maximum number of records to return.
querystringRequired
YouTube video search query.
countrystringOptional
Two-letter country code used to localize YouTube results.
languagestringOptional
Two-letter language code for YouTube results.

Raw input JSON Schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of records to return."
    },
    "query": {
      "type": "string",
      "maxLength": 1000,
      "minLength": 1,
      "description": "YouTube video search query."
    },
    "country": {
      "type": "string",
      "default": "us",
      "pattern": "^[A-Za-z]{2}quot;,
      "description": "Two-letter country code used to localize YouTube results."
    },
    "language": {
      "type": "string",
      "default": "en",
      "pattern": "^[A-Za-z]{2}quot;,
      "description": "Two-letter language code for YouTube results."
    }
  },
  "additionalProperties": false
}

Returns

Fields a successful serp.youtube call returns.

querystringRequired
videosarray of objectRequired
- linkstringRequired
- titlestringRequired
- viewsnumber | nullRequired
- lengthstring | nullRequired
- channelstring | nullRequired
- positionnumberRequired
- thumbnailstring | nullRequired
- descriptionstring | nullRequired
- channel_linkstring | nullRequired
- published_datestring | nullRequired
messagestring | nullRequired
Set when YouTube returned no videos. Null when videos were returned.
search_idstringRequired
retrieved_atstring (date-time)Required

Raw output JSON Schema

{
  "type": "object",
  "required": [
    "query",
    "videos",
    "message",
    "search_id",
    "retrieved_at"
  ],
  "properties": {
    "query": {
      "type": "string"
    },
    "videos": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "position",
          "title",
          "link",
          "channel",
          "channel_link",
          "published_date",
          "views",
          "length",
          "description",
          "thumbnail"
        ],
        "properties": {
          "link": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "views": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 0
          },
          "length": {
            "type": [
              "string",
              "null"
            ]
          },
          "channel": {
            "type": [
              "string",
              "null"
            ]
          },
          "position": {
            "type": "number",
            "minimum": 0
          },
          "thumbnail": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": [
              "string",
              "null"
            ]
          },
          "channel_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "published_date": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      },
      "maxItems": 100
    },
    "message": {
      "type": [
        "string",
        "null"
      ],
      "description": "Set when YouTube returned no videos. Null when videos were returned."
    },
    "search_id": {
      "type": "string"
    },
    "retrieved_at": {
      "type": "string",
      "format": "date-time"
    }
  },
  "additionalProperties": false
}

Run this tool

Copy this instruction to your agent to set up Cralo and call this tool with the example input.

Set up Cralo by following https://cralo.ai/SKILL.md, then call the serp.youtube tool with this input: {"query":"artificial intelligence","country":"us","language":"en"}

Start with $1 free See pricing

Safety notes

Side Effect: read_only
Public Sources Only: Yes

How this compares to using SerpApi directly

You do not need a separate SerpApi account or subscription for this call. Cralo uses one prepaid balance across all tools and shows the per-call price before you run the command.

Related tools

[Browse all tools]