Skip to main content
GET
Search Videos
Search YouTube and get back matching videos, channels, and playlists. Set engine=youtube and pass the query in q; both are required. Optionally narrow by country (gl) and interface language (hl), or pass a YouTube filter token in sp for pagination and advanced filters such as upload date, duration, or result type. Use this to find video content on a topic, track a channel’s recent uploads, or gauge how much video coverage a subject has. Note: this is served through the AIsa mapped path /apis/v1/youtube/search; the upstream provider’s canonical path is not mounted directly.
First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.
Set this endpoint up in your agent →

Request contract

  • Method and path: GET /apis/v1/youtube/search
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/youtube/search
  • engine: query; required
  • gl: query; optional
  • hl: query; optional
  • q: query; required
  • sp: query; optional
  • Runtime facts: 7856a6c3cdb43dbf15e31461496a037f7df2217d189dadb9d27f406316aa651d
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Published reference price: $0.0029 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.0029
  • Cost contract: fixed_success
  • Published reference multiplier: 1.0
  • Settlement evidence source: request_snapshot

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

engine
enum<string>
required

SearchApi engine identifier. Use youtube for this YouTube endpoint.

Available options:
youtube
gl
string

Country code (e.g. us, jp)

hl
string

Interface language

q
string
required

Search query. Required by runtime and upstream SearchApi.

sp
string

YouTube filter token (pagination or advanced filters)

Response

Successful response

ads
object[]

Advertisement results

channels
object[]

YouTube channel results

error
string

Error message if the search failed

movies
object[]

Movie results

pagination
object
people_also_search_for
object[]

Related search suggestions

playlists
object[]

Playlist results

posts
object[]

Community post results

search_information
object
search_metadata
object
search_parameters
object
sections
object[]

Section results

shorts
object[]

YouTube Shorts results

suggestions
string[]

Search query suggestions

videos
object[]

Video search results