search_endpoints

Free. Search fetcher.sh's YouTube endpoints by keyword. Returns paths, descriptions and per-call prices. Start here.

Parameters1

query

string

optional

Keywords, e.g. 'twitter followers' or 'reviews'

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keywords, e.g. 'twitter followers' or 'reviews'"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

describe_endpoint

Free. Show the full call signature for one endpoint: required and optional parameters, allowed values, price, and response shape.

Parameters1

path

string

required

Endpoint path, e.g. /api/twitter/search or /api/twitter/handle/{handle}

Raw schema

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Endpoint path, e.g. /api/twitter/search or /api/twitter/handle/{handle}"
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

fetch_data

Paid. Fetch live data from any YouTube endpoint. Pass the endpoint path plus its parameters (path and query parameters together in `params`). Priced per call in USDC on Base, Polygon, Arbitrum, Monad or Solana: pay with x402, or send an Authorization: Bearer bby_live_... header to spend prepaid credits. Call describe_endpoint first if unsure about parameters.

Parameters2

path	string	required	Endpoint path from search_endpoints, e.g. /api/youtube/search/video
params	object	optional	All parameters for the endpoint, path and query alike, e.g. { query: 'x402', sort: 'Latest' }

Raw schema

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Endpoint path from search_endpoints, e.g. /api/youtube/search/video"
    },
    "params": {
      "type": "object",
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      },
      "description": "All parameters for the endpoint, path and query alike, e.g. { query: 'x402', sort: 'Latest' }"
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_balance

Free. Show the remaining credit balance for the API key sent in this connection's Authorization header. Call this before a long run of paid requests.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

topup_credits

Paid (the amount you choose, minimum $1). Buy prepaid credits with x402 so later calls skip the per-call payment round trip. With an Authorization: Bearer bby_live_... header on this connection it recharges that key. Without one, the paying wallet becomes the account and a new API key is minted and returned once — store it as a secret, it cannot be recovered.

Parameters2

amount	number	required	Amount to add, in USD. Minimum 1.
rotate	boolean	optional	Mint a replacement key for the paying wallet, invalidating the old one immediately. Only valid when no Authorization header is sent.

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number",
      "minimum": 1,
      "description": "Amount to add, in USD. Minimum 1."
    },
    "rotate": {
      "type": "boolean",
      "description": "Mint a replacement key for the paying wallet, invalidating the old one immediately. Only valid when no Authorization header is sent."
    }
  },
  "required": [
    "amount"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

youtube_search_video

Paid ($0.005). Search video — YouTube. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Parameters8

query	string	required	Required.
cursor	string	optional	Optional.
duration	string	optional	Optional. One of: short, medium, long.
features	string	optional	Optional. One of: hd, subtitles, creative_commons, 3d, live, purchased, 4k, 360, location, hdr, vr180.
uploadDate	string	optional	Optional. One of: hour, today, week, month, year.
sortBy	string	optional	Optional. One of: relevance, rating, upload_date, view_count.
lang	string	optional	Optional.
geo	string	optional	Optional.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Required."
    },
    "cursor": {
      "type": "string",
      "description": "Optional."
    },
    "duration": {
      "type": "string",
      "enum": [
        "short",
        "medium",
        "long"
      ],
      "description": "Optional. One of: short, medium, long."
    },
    "features": {
      "type": "string",
      "enum": [
        "hd",
        "subtitles",
        "creative_commons",
        "3d",
        "live",
        "purchased",
        "4k",
        "360",
        "location",
        "hdr",
        "vr180"
      ],
      "description": "Optional. One of: hd, subtitles, creative_commons, 3d, live, purchased, 4k, 360, location, hdr, vr180."
    },
    "uploadDate": {
      "type": "string",
      "enum": [
        "hour",
        "today",
        "week",
        "month",
        "year"
      ],
      "description": "Optional. One of: hour, today, week, month, year."
    },
    "sortBy": {
      "type": "string",
      "enum": [
        "relevance",
        "rating",
        "upload_date",
        "view_count"
      ],
      "description": "Optional. One of: relevance, rating, upload_date, view_count."
    },
    "lang": {
      "type": "string",
      "description": "Optional."
    },
    "geo": {
      "type": "string",
      "description": "Optional."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

YouTube data for agents

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_endpoints

describe_endpoint

fetch_data

check_balance

topup_credits

youtube_search_video

Install

Remote endpoint