OpenClaw YouTube 📺

YouTube SERP Scout for autonomous agents. Powered by AIsa.

One API key. Rank discovery. Content research. Competitor tracking.

🔥 What Can You Do?

Content Research

CODEBLOCK0

Competitor Tracking

CODEBLOCK1

Trend Discovery

CODEBLOCK2

Topic Analysis

CODEBLOCK3

Channel Discovery

CODEBLOCK4

Quick Start

CODEBLOCK5

Core Capabilities

Basic YouTube Search

CODEBLOCK6

Search with Country Filter

CODEBLOCK7

Search with Language Filter

CODEBLOCK8

Pagination with Filter Token

CODEBLOCK9

Python Client

CODEBLOCK10

Use Cases

1. Content Gap Analysis

Find what content is ranking well to identify gaps in your strategy:

CODEBLOCK11

2. Competitor Monitoring

Track what competitors are publishing:

CODEBLOCK12

3. Keyword Research

Discover what topics are trending:

CODEBLOCK13

4. Audience Research

Understand what your target audience watches:

CODEBLOCK14

5. SEO Analysis

Analyze how videos rank for specific keywords:

CODEBLOCK15

API Endpoint Reference

Endpoint	Method	Description
INLINECODE0	GET	Search YouTube SERP

Request Parameters

Parameter	Type	Required	Description
engine	string	Yes	Must be INLINECODE1
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 |

Response Format

CODEBLOCK16

Country Codes (gl)

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 |

Language Codes (hl)

Code	Language
en	English
ja

Pricing

API	Cost
YouTube search	~$0.002

Every response includes usage.cost and usage.credits_remaining.

Get Started

1. Sign up at aisa.one
Get your API key
Add credits (pay-as-you-go)
Set environment variable: INLINECODE11

Full API Reference

See API Reference for complete endpoint documentation.

OpenClaw YouTube 📺

面向自主智能体的YouTube SERP侦察工具。由AIsa驱动。

一个API密钥。排名发现。内容研究。竞争对手追踪。

🔥 你能做什么？

内容研究

查找关于AI智能体教程的排名靠前视频，了解哪些内容效果最佳

竞争对手追踪

搜索竞争对手频道中关于机器学习的视频

趋势发现

当前关于GPT-5的热门YouTube视频有哪些？

主题分析

查找关于自动驾驶的热门视频，了解受众兴趣

频道发现

搜索创建关于加密货币交易内容的频道

快速开始

bash
export AISAAPIKEY=your-key

核心功能

基础YouTube搜索

bash

搜索视频

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

带国家筛选的搜索

bash

在特定国家搜索（美国）

curl https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=machine+learning&gl=us \
-H Authorization: Bearer $AISAAPIKEY

在日本搜索

curl https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI&gl=jp&hl=ja \ -H Authorization: Bearer $AISAAPIKEY

带语言筛选的搜索

bash

使用界面语言搜索

curl https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=python+tutorial&hl=en \
-H Authorization: Bearer $AISAAPIKEY

中文界面

curl https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=编程教程&hl=zh-CN&gl=cn \ -H Authorization: Bearer $AISAAPIKEY

使用筛选令牌进行分页

bash

使用sp参数进行分页或高级筛选

curl https://api.aisa.one/apis/v1/youtube/search?engine=youtube&q=AI&sp= \
-H Authorization: Bearer $AISAAPIKEY

Python客户端

bash

基础搜索

python3 {baseDir}/scripts/youtube_client.py search --query AI agents tutorial

带国家搜索

python3 {baseDir}/scripts/youtube_client.py search --query machine learning --country us

带语言搜索

python3 {baseDir}/scripts/youtube_client.py search --query python tutorial --lang en

完整选项

python3 {baseDir}/scripts/youtube_client.py search --query GPT-5 news --country us --lang en

竞争对手研究

python3 {baseDir}/scripts/youtube_client.py search --query OpenAI tutorial

趋势发现

python3 {baseDir}/scripts/youtube_client.py search --query AI trends 2025

使用场景

1. 内容差距分析

查找排名靠前的内容，识别策略中的空白：

python

搜索你领域内的热门视频

results = client.search(AI automation tutorial)

分析标题、观看次数和频道，寻找机会

2. 竞争对手监控

追踪竞争对手发布的内容：

python

搜索竞争对手品牌+主题

results = client.search(OpenAI GPT tutorial)

监控排名随时间的变化

3. 关键词研究

发现哪些主题正在流行：

python

搜索广泛主题，了解哪些内容受欢迎

results = client.search(artificial intelligence 2025)

从排名靠前的标题中提取常见关键词

4. 受众研究

了解目标受众观看的内容：

python

在特定地区搜索

results = client.search(coding tutorial, country=jp, lang=ja)

分析地区内容偏好

5. SEO分析

分析视频在特定关键词下的排名情况：

python

追踪目标关键词的排名位置

keywords = [AI tutorial, machine learning basics, Python AI]
for kw in keywords:
results = client.search(kw)
# 记录前10个视频及其频道

API端点参考

端点	方法	描述
/youtube/search	GET	搜索YouTube SERP

请求参数

参数	类型	必填	描述
engine	字符串	是	必须为youtube
q

字符串 | 是 | 搜索查询 | | gl | 字符串 | 否 | 国家代码（例如us、jp、uk、cn） | | hl | 字符串 | 否 | 界面语言（例如en、ja、zh-CN） | | sp | 字符串 | 否 | YouTube筛选令牌，用于分页/筛选 |

响应格式

json
{
search_metadata: {
id: search_id,
status: Success,
created_at: 2025-01-15T12:00:00Z,
requesttimetaken: 1.23,
totaltimetaken: 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
}
]
}

国家代码（gl）

代码	国家
us	美国
uk

英国 |
| jp | 日本 |
| cn | 中国 |
| de | 德国 |
| fr | 法国 |
| kr | 韩国 |
| in | 印度 |
| br | 巴西 |
| au | 澳大利亚 |

语言代码（hl）

代码	语言
en	英语
ja

日语 | | zh-CN | 中文（简体） | | zh-TW | 中文（繁体） | | ko | 韩语 | | de | 德语 | | fr | 法语 | | es | 西班牙语 | | pt | 葡萄牙语 | | ru | 俄语 |

定价

API	费用
YouTube搜索	~$0.002

每次响应都包含usage.cost和usage.credits_remaining。

开始使用

1. 在aisa.one注册
获取您的API密钥
添加积分（按需付费）
设置环境变量：export AISAAPI_KEY=your-key

完整API参考

查看API参考获取完整的端点文档。

openclaw-youtubeYouTube SERP侦察器