\r \r

OpenClaw YouTube 📺\r

\r YouTube SERP Scout for autonomous agents. Powered by AIsa.\r \r One API key. Rank discovery. Content research. Competitor tracking.\r \r

🔥 What Can You Do?\r

\r

Content Research\r

"Find top-ranking videos about 'AI agents tutorial' to see what's working"\r
```\r
\r
### Competitor Tracking\r
```\r
"Search for videos from competitor channels about 'machine learning'"\r
```\r
\r
### Trend Discovery\r
```\r
"What are the top YouTube videos about 'GPT-5' right now?"\r
```\r
\r
### Topic Analysis\r
```\r
"Find popular videos on 'autonomous driving' to understand audience interest"\r
```\r
\r
### Channel Discovery\r
```\r
"Search for channels creating content about 'crypto trading'"\r
```\r
\r
## Quick Start\r
\r
```bash\r
export AISA_API_KEY="your-key"\r
```\r
\r
---\r
\r
## Core Capabilities\r
\r
### Basic YouTube Search\r
\r
```bash\r
# Search for videos\r
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI+agents+tutorial" \\r
  -H "Authorization: Bearer $AISA_API_KEY"\r
```\r
\r
### Search with Country Filter\r
\r
```bash\r
# Search in specific country (US)\r
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=machine+learning&gl=us" \\r
  -H "Authorization: Bearer $AISA_API_KEY"\r
\r
# Search in Japan\r
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI&gl=jp&hl=ja" \\r
  -H "Authorization: Bearer $AISA_API_KEY"\r
```\r
\r
### Search with Language Filter\r
\r
```bash\r
# Search with interface language\r
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=python+tutorial&hl=en" \\r
  -H "Authorization: Bearer $AISA_API_KEY"\r
\r
# Chinese interface\r
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=编程教程&hl=zh-CN&gl=cn" \\r
  -H "Authorization: Bearer $AISA_API_KEY"\r
```\r
\r
### Pagination with Filter Token\r
\r
```bash\r
# Use sp parameter for pagination or advanced filters\r
curl "https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI&sp=\x3Cfilter_token>" \\r
  -H "Authorization: Bearer $AISA_API_KEY"\r
```\r
\r
---\r
\r
## Python Client\r
\r
```bash\r
# Basic search\r
python3 {baseDir}/scripts/youtube_client.py search --query "AI agents tutorial"\r
\r
# Search with country\r
python3 {baseDir}/scripts/youtube_client.py search --query "machine learning" --country us\r
\r
# Search with language\r
python3 {baseDir}/scripts/youtube_client.py search --query "python tutorial" --lang en\r
\r
# Full options\r
python3 {baseDir}/scripts/youtube_client.py search --query "GPT-5 news" --country us --lang en\r
\r
# Competitor research\r
python3 {baseDir}/scripts/youtube_client.py search --query "OpenAI tutorial"\r
\r
# Trend discovery\r
python3 {baseDir}/scripts/youtube_client.py search --query "AI trends 2025"\r
```\r
\r
---\r
\r
## Use Cases\r
\r
### 1. Content Gap Analysis\r
\r
Find what content is ranking well to identify gaps in your strategy:\r
\r
```python\r
# Search for top videos in your niche\r
results = client.search("AI automation tutorial")\r
# Analyze titles, views, and channels to find opportunities\r
```\r
\r
### 2. Competitor Monitoring\r
\r
Track what competitors are publishing:\r
\r
```python\r
# Search for competitor brand + topic\r
results = client.search("OpenAI GPT tutorial")\r
# Monitor ranking changes over time\r
```\r
\r
### 3. Keyword Research\r
\r
Discover what topics are trending:\r
\r
```python\r
# Search broad topics to see what's popular\r
results = client.search("artificial intelligence 2025")\r
# Extract common keywords from top-ranking titles\r
```\r
\r
### 4. Audience Research\r
\r
Understand what your target audience watches:\r
\r
```python\r
# Search in specific regions\r
results = client.search("coding tutorial", country="jp", lang="ja")\r
# Analyze regional content preferences\r
```\r
\r
### 5. SEO Analysis\r
\r
Analyze how videos rank for specific keywords:\r
\r
```python\r
# Track ranking positions for target keywords\r
keywords = ["AI tutorial", "machine learning basics", "Python AI"]\r
for kw in keywords:\r
    results = client.search(kw)\r
    # Record top 10 videos and their channels\r
```\r
\r
---\r
\r
## API Endpoint Reference\r
\r
| Endpoint | Method | Description |\r
|----------|--------|-------------|\r
| `/youtube/search` | GET | Search YouTube SERP |\r
\r
## Request Parameters\r
\r
| Parameter | Type | Required | Description |\r
|-----------|------|----------|-------------|\r
| engine | string | Yes | Must be `youtube` |\r
| q | string | Yes | Search query |\r
| gl | string | No | Country code (e.g., `us`, `jp`, `uk`, `cn`) |\r
| hl | string | No | Interface language (e.g., `en`, `ja`, `zh-CN`) |\r
| sp | string | No | YouTube filter token for pagination/filters |\r
\r
## Response Format\r
\r
```json\r
{\r
  "search_metadata": {\r
    "id": "search_id",\r
    "status": "Success",\r
    "created_at": "2025-01-15T12:00:00Z",\r
    "request_time_taken": 1.23,\r
    "total_time_taken": 1.45\r
  },\r
  "search_results": [\r
    {\r
      "video_id": "abc123xyz",\r
      "title": "Complete AI Agents Tutorial 2025",\r
      "link": "https://www.youtube.com/watch?v=abc123xyz",\r
      "channel_name": "AI Academy",\r
      "channel_link": "https://www.youtube.com/@aiacademy",\r
      "description": "Learn how to build AI agents from scratch...",\r
      "views": "125K views",\r
      "published_date": "2 weeks ago",\r
      "duration": "45:30",\r
      "thumbnail": "https://i.ytimg.com/vi/abc123xyz/hqdefault.jpg"\r
    }\r
  ]\r
}\r
```\r
\r
---\r
\r
## Country Codes (gl)\r
\r
| Code | Country |\r
|------|---------|\r
| us | United States |\r
| uk | United Kingdom |\r
| jp | Japan |\r
| cn | China |\r
| de | Germany |\r
| fr | France |\r
| kr | South Korea |\r
| in | India |\r
| br | Brazil |\r
| au | Australia |\r
\r
## Language Codes (hl)\r
\r
| Code | Language |\r
|------|----------|\r
| en | English |\r
| ja | Japanese |\r
| zh-CN | Chinese (Simplified) |\r
| zh-TW | Chinese (Traditional) |\r
| ko | Korean |\r
| de | German |\r
| fr | French |\r
| es | Spanish |\r
| pt | Portuguese |\r
| ru | Russian |\r
\r
---\r
\r
## Pricing\r
\r
| API | Cost |\r
|-----|------|\r
| YouTube search | ~$0.002 |\r
\r
Every response includes `usage.cost` and `usage.credits_remaining`.\r
\r
---\r
\r
## Get Started\r
\r
1. Sign up at [aisa.one](https://aisa.one)\r
2. Get your API key\r
3. Add credits (pay-as-you-go)\r
4. Set environment variable: `export AISA_API_KEY="your-key"`\r
\r
## Full API Reference\r
\r
See [API Reference](https://docs.aisa.one/reference/) for complete endpoint documentation.\r