Skip to main content

Documentation Index

Fetch the complete documentation index at: https://aisa.one/docs/llms.txt

Use this file to discover all available pages before exploring further.

View on GitHub -> YouTube discovery through AIsa. Search videos, channels, and playlists for research, trend monitoring, and content planning.

​
Install

aisa skills install aisa-youtube-search

​
What can agents do with it?

Video discovery

Find relevant videos for a query or topic.

Channel research

Identify channels covering a niche.

Playlist lookup

Find curated video collections.

Topic exploration

Use YouTube as an input for research workflows.

​
When to use

  • The user wants to search YouTube videos, channels, or playlists.
  • The task needs region or language filters without direct Google API setup.
  • The workflow can call the AIsa YouTube search endpoint with AISA_API_KEY.

​
When NOT to use

  • The user needs browser automation, local scraping, or direct YouTube account actions.
  • The workflow must avoid sending search requests to api.aisa.one.
  • The request depends on a local helper script that is not part of this package.

​
Quick Reference

  • Required environment variable: AISA_API_KEY
  • Endpoint: https://api.aisa.one/apis/v1/youtube/search
  • This package is curl-first and does not ship a local Python client.

​
Setup

export AISA_API_KEY="your-key"

​
Common Commands

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

curl -s "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI+news&gl=us&hl=en" \
  -H "Authorization: Bearer $AISA_API_KEY"

curl -s "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=python+tutorial&sp=EgIQAQ%3D%3D" \
  -H "Authorization: Bearer $AISA_API_KEY"

​
Capabilities

  • Search YouTube SERP results with q
  • Filter by locale with gl and hl
  • Apply pagination or narrowing via sp
  • Return structured results that may include videos or grouped sections

​
Guardrails

  • Do not ask for Google credentials or browser cookies.
  • Do not claim a result is local-only when it depends on relay requests.
  • Do not fabricate missing filters or parameters.

​
Security Notes

  • All search requests go to api.aisa.one.
  • Required secret: AISA_API_KEY.
  • This workflow does not require passwords, browser automation, or local scraping.

​
Get started

  1. Sign up at aisa.one (new accounts start with $2 free credit).
  2. Generate an API key from the console.
  3. Set your key and install the skill: 
    export AISA_API_KEY="your-key"
aisa skills install aisa-youtube-search
  4. Start a new agent session so the runtime loads the updated skill instructions.

YouTube SERP

Ranked YouTube SERP results with rich metadata.

YouTube Search

General YouTube content research workflow.

Multi-source Search

Combine YouTube with web and scholar search.