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