Skip to main content
View on GitHub → YouTube search results and rich metadata for autonomous agents. One AISA_API_KEY returns ranked videos, view counts, publication dates, and thumbnails — filterable by country and language.

​
Install

First, install the AIsa CLI if you have not already: 
npm install -g @aisa-one/cli
Then install the skill: 
aisa skills install youtube-serp

​
What can agents do with it?

Content gap analysis

“Find what’s ranking for ‘AI agent tutorial’ that our channel doesn’t cover.”

Competitor monitoring

“Track new uploads from the top 5 channels in this niche.”

Keyword research

“Which variations of ‘RAG’ pull the biggest view counts?”

Regional trends

“Surface top ML content in Japan (jp/ja) vs. the US (us/en).”

Audience research

“What thumbnails and titles work for agent demos?”

Trend spotting

“Flag videos with unusual velocity relative to channel baseline.”

​
Core capabilities

  • Keyword search — ranked YouTube results for any query
  • Regional targeting — gl (country: us, jp, cn, …) and hl (interface language: en, ja, zh-CN, …)
  • Rich metadata — titles, channels, view counts, publication dates, durations, thumbnails
  • Pagination — filter tokens for navigating beyond the first page

​
Quick start

export AISA_API_KEY="your-key"

curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI+agents+tutorial" \
  -H "Authorization: Bearer $AISA_API_KEY"

​
Region + language

# ML content in Japan, Japanese interface
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=machine+learning&gl=jp&hl=ja" \
  -H "Authorization: Bearer $AISA_API_KEY"

# AI trends in US, English interface
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI+trends+2026&gl=us&hl=en" \
  -H "Authorization: Bearer $AISA_API_KEY"

​
Pagination

The response includes a pagination token you can pass back to fetch the next page: 
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI+agents&sp=NEXT_PAGE_TOKEN" \
  -H "Authorization: Bearer $AISA_API_KEY"

​
Python client

# Basic
python3 scripts/youtube_client.py search --query "autonomous agents"

# With country
python3 scripts/youtube_client.py search --query "coding tutorial" --country us

# With country + language
python3 scripts/youtube_client.py search --query "機械学習" --country jp --lang ja

​
Endpoint reference

EndpointMethodPurpose
/youtube/searchGETYouTube search
Common parameters:
  • engine — always youtube
  • q — search query (required)
  • gl — country code (us, jp, cn, etc.)
  • hl — language code (en, ja, zh-CN, etc.)
  • sp — pagination token

​
Get started

  1. Sign up at aisa.one (new accounts start with $2 free credit).
  2. Generate an API key from the console.
  3. export AISA_API_KEY="your-key" and install the skill: 
    npm install -g @aisa-one/cli
aisa skills install youtube-serp

YouTube Search endpoint

Full endpoint reference with interactive playground.

Multi-source Search

Combine YouTube search with web, scholar, and Tavily.

Error Codes

Handling YouTube API-level errors.