YepAPI 技能集

YepAPI — API 参考

Base URL: https://api.yepapi.com Auth: x-api-key header Response: { ok: true, data: {...} } 或 { ok: false, error: { code, message } } Rate limit: 60 req/min

SEO — 关键词

方法	路径	费用	必需参数	描述
POST	/v1/seo/keywords	$0.15	keywords[], location	批量指标：搜索量、每次点击费用 (CPC)、难度、意图、趋势（最多 100 个）
POST	/v1/seo/keywords/ideas	$0.03	keyword, location	基于种子关键词的关键词建议
POST	/v1/seo/keywords/related	$0.03	keyword, location	种子关键词的相关关键词

返回：volume、cpc、difficulty (0-100)、intent (informational/commercial/navigational/transactional)、trend (12 个月数组)

SERP

方法	路径	费用	必需参数	描述
POST	/v1/serp/google	$0.01	query, location	Google 自然搜索结果
POST	/v1/serp/google/news	$0.01	query, location	Google 新闻结果
POST	/v1/serp/google/maps	$0.01	query, location	Google 地图 / 本地结果

返回：results[]，包含 title、url、snippet、position。Maps 额外返回 rating、reviews、address、phone。

域名分析

方法	路径	费用	必需参数	描述
POST	/v1/seo/domain/overview	$0.01	domain	流量、关键词、反向链接、域名排名
POST	/v1/seo/domain/keywords	$0.04	domain	域名排名的关键词
POST	/v1/seo/domain/backlinks	$0.05	domain	域名反向链接概览

返回：overview 提供 traffic、keywords_count、backlinks、domain_rank。Keywords 提供 keyword、position、volume、url。

竞争对手

方法	路径	费用	必需参数	描述
POST	/v1/seo/competitors	$0.04	domain	通过关键词重叠度发现竞争对手域名
POST	/v1/seo/keyword-gap	$0.04	domain, competitor	两个域名之间的关键词差距

返回：competitors 提供 domain、overlap、traffic。Gap 提供 keyword、your_position、competitor_position、volume。

反向链接

方法	路径	费用	必需参数	描述
POST	/v1/seo/backlinks	$0.05	target	指向域名/URL 的单个反向链接
POST	/v1/seo/backlinks/summary	$0.03	target	聚合指标 + dofollow 比例
POST	/v1/seo/referring-domains	$0.03	target	引用域名及其权威度

返回：summary 提供 total_backlinks、dofollow_ratio、domain_rank。Backlinks 提供 source_url、anchor、type、domain_rank。

页面内优化与趋势

方法	路径	费用	必需参数	描述
POST	/v1/seo/page-audit	$0.03	url	技术 SEO 审计（元数据、标题、链接、图片）
POST	/v1/seo/lighthouse	$0.05	url	Lighthouse 得分（性能、无障碍、SEO、最佳实践）
POST	/v1/seo/trends	$0.02	keywords[]	Google Trends 随时间变化的兴趣度（最多 5 个关键词）

返回：page-audit 提供 issues[]、meta、headings、links、images。Lighthouse 提供 performance、accessibility、seo、best_practices (0-100)。Trends 提供 interest_over_time[]。

AI 可见性

方法	路径	费用	必需参数	描述
POST	/v1/seo/ai/chatgpt	$0.05	query	ChatGPT 对品牌/查询的看法
POST	/v1/seo/ai/gemini	$0.05	query	Gemini 对品牌/查询的看法

返回：response (文本)、mentions[]、sentiment。

网页抓取

方法	路径	费用	必需参数	描述
POST	/v1/scrape	$0.01	url	抓取为 Markdown/HTML/文本
POST	/v1/scrape/js	$0.02	url	JS 渲染页面抓取（无头浏览器）
POST	/v1/scrape/stealth	$0.03	url	反机器人绕过（住宅代理）
POST	/v1/scrape/ai-extract	$0.03	url, prompt	AI 驱动的结构化提取

可选参数：format ("markdown"/"html"/"text")、waitFor (CSS 选择器)、timeout (毫秒)。 返回：content (字符串)、metadata (标题、描述、URL)。

YouTube

方法	路径	费用	必需参数	描述
POST	/v1/youtube/search	$0.01	query	搜索视频、频道、播放列表
POST	/v1/youtube/video	$0.02	videoId	完整视频元数据 + 格式
POST	/v1/youtube/transcript	$0.01	videoId	带时间戳的字幕
POST	/v1/youtube/channel	$0.01	channelId 或 handle	频道概览
POST	/v1/youtube/comments	$0.01	videoId	评论和回复

返回：search 提供 results[]，包含 videoId、title、views、published。Transcript 提供 segments[]，包含 text、start、duration。

AI 聊天

方法	路径	费用	必需参数	描述
POST	/v1/ai/chat	变量	model, messages[]	与 69 个 AI 模型聊天
GET	/v1/ai/models	免费	—	列出可用模型及定价

公共可选字段

SEO 端点：location (默认 "us")、language (默认 "en")、limit、offset。 抓取端点：format、waitFor、timeout。

错误代码

代码	HTTP	含义
INVALID_API_KEY	401	缺少或无效的密钥
REVOKED_API_KEY	401	密钥已吊销
NO_CREDITS	402	余额不足
RATE_LIMITED	429	超出 60 请求/分钟限制
VALIDATION_ERROR	400	请求体错误
UPSTREAM_ERROR	502	上游提供商错误
MODEL_NOT_FOUND	400	无效的 AI 模型
AI_UPSTREAM_ERROR	502	AI 提供商错误
STREAM_ERROR	502	SSE 中断
NOT_FOUND	404	未找到端点
INTERNAL_ERROR	500	服务器错误

链接

• 文档：https://docs.yepapi.com
• 仪表盘：https://yepapi.com/dashboard
• API 密钥：https://yepapi.com/dashboard/api-keys
• 完整参考：https://docs.yepapi.com/llms-full.txt
• MCP 服务器：npx -y @yepapi/mcp