> ## 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.

# AIsa YouTube Search

> Search YouTube videos, channels, and playlists through AIsa.

[View on GitHub ->](https://github.com/AIsa-team/agent-skills/tree/main/aisa-youtube-search)

**YouTube discovery through AIsa.** Search videos, channels, and playlists for research, trend monitoring, and content planning.

## Install

First, install the AIsa CLI if you have not already:

```bash theme={null}
npm install -g @aisa-one/cli
```

Then install the skill:

```bash theme={null}
aisa skills install aisa-youtube-search
```

## What can agents do with it?

<CardGroup cols={2}>
  <Card title="Video discovery" icon="youtube">
    Find relevant videos for a query or topic.
  </Card>

  <Card title="Channel research" icon="users">
    Identify channels covering a niche.
  </Card>

  <Card title="Playlist lookup" icon="list">
    Find curated video collections.
  </Card>

  <Card title="Topic exploration" icon="compass">
    Use YouTube as an input for research workflows.
  </Card>
</CardGroup>

## 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

```bash theme={null}
export AISA_API_KEY="your-key"
```

## Common Commands

```bash theme={null}
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](https://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:
   ```bash theme={null}
   export AISA_API_KEY="your-key"
   npm install -g @aisa-one/cli
   aisa skills install aisa-youtube-search
   ```
4. Start a new agent session so the runtime loads the updated skill instructions.

## Related

<CardGroup cols={3}>
  <Card title="YouTube SERP" icon="youtube" href="/agent-skills/youtube-search">
    Ranked YouTube SERP results with rich metadata.
  </Card>

  <Card title="YouTube Search" icon="youtube" href="/agent-skills/youtube-search-skill">
    General YouTube content research workflow.
  </Card>

  <Card title="Multi-source Search" icon="magnifying-glass" href="/agent-skills/search">
    Combine YouTube with web and scholar search.
  </Card>
</CardGroup>