API v1.1 · 稳定版

一行代码,接入 GEO 全能力

AI搜索模拟、GEO健康检测、AI可见性分析——无需自建模型,调用即用。为开发者和企业打造的GEO基础设施。

🚀 快速开始 💰 查看定价
6+
API 端点
5
AI 平台覆盖
99.5%
服务可用性
<3s
平均响应

调用 API,你能得到什么?

不用自己建模型、不用写算法,一行代码拿到专业 GEO 分析结果。以下是每个端点返回给您的数据:

🔥 AI搜索模拟

5大AI平台会不会推荐你?

输入品牌+行业,系统模拟ChatGPT/文心一言/Kimi/豆包/DeepSeek,告诉你每个平台是否主动推荐了你的品牌。

你拿到的数据 ↓
品牌名 — 你查的是谁
各平台推荐结果 — 是否被推荐 + 推荐理由
排名位次 — 在推荐列表第几位
综合评分 — 0-5分,5分=5个平台都推荐你
🩺 GEO健康检测

你的网站对AI够友好吗?

AI分析你的网站内容、结构、技术配置,生成GEO健康评分和逐项优化建议。

你拿到的数据 ↓
健康评分 — 0-100分
5大维度评分 — 内容质量/结构化数据/技术SEO/AI可读性/权威性
问题清单 — 具体哪里有问题
优化建议 — 每个问题怎么修
👁️ AI可见性检测

AI能"看到"你的网站吗?

检测你的网站在AI搜索场景下是否可被发现、可被理解、可被推荐。

你拿到的数据 ↓
可见性评分 — 0-100分
发现能力 — AI能不能找到你
理解能力 — AI能不能看懂你
推荐能力 — AI愿不愿推荐你
🔧 基础检测(低成本)

Meta标签 / Robots / 索引量

不调用AI,纯技术检测。速度快、额度消耗少,适合批量调用。

你拿到的数据 ↓
Meta标签 — title/description/og标签是否完整
Robots.txt — 是否允许AI爬虫抓取
索引量 — 搜索引擎收录页面数量
💡 每次调用只消耗"普通调用"额度

📝 一句话说明白

🎨 数据格式
所有接口返回 JSON 数据,这是程序员最熟悉的格式。你的开发团队可以直接读取并展示在自己的系统里。
📊 用量追踪
每次调用的响应头自动包含 已用次数 / 总额度,方便你在代码中实时监控剩余额度,快用完时提醒续费。
🔄 怎么用这些数据
嵌入你的产品做GEO功能 → 定期检测生成报告 → 监控竞品GEO表现 → 卖给你的客户做增值服务。数据是你的,怎么展示你说了算。

🏷️ 白标能力 — 贴你的牌子,卖你的产品

调用云丝路 API 获取数据,但你的客户看到的完全是你的品牌、你的产品、你的界面。他们不会知道背后是云丝路在提供能力。

🚫

返回数据中没有云丝路标识

JSON 响应里只有纯数据:评分、推荐结果、优化建议。没有云丝路 logo、没有云丝路链接、没有任何第三方品牌痕迹。

🎨

你自己决定怎么展示

做成你的仪表盘、嵌入你的产品、生成你的报告、发你的邮件。数据拿到手,界面完全由你设计,品牌100%是你的。

💰

你定价格,你赚差价

你从云丝路按量付费,转手以你的品牌和价格卖给你的客户。中间利润空间完全由你掌控,你的客户只知道他们在用你的产品。

💡 典型使用场景

SEO公司
把GEO检测做成自己的服务,给客户出报告,加在自己的套餐里卖
SaaS产品
在自己的产品里加"GEO检测"功能模块,用户无感知背后是云丝路
建站公司
给客户做完网站后,用API定期检测GEO表现,做增值维护服务

简洁定价,按需选择

AI调用(调大模型)与普通调用分别计量,只为真实成本付费。

免费体验
¥0/月
适合试用和评估
  • AI调用 1次/月
  • 普通检测 10次/月
  • 社区支持
开发者
¥99/月
个人开发者 & 小项目
  • AI调用 200次/月
  • 普通检测 1000次/月
  • 最大并发 2
  • 邮件支持
无限
¥699/月
大型团队 & 高频场景
  • AI调用 1500次/月
  • 普通检测 不限
  • 最大并发 10
  • 专属支持
  • 加量包 ¥40/100次

三步接入

1

注册 & 获取 API Key

注册云丝路账号后,在控制台自动生成专属 API Key(格式:ysl_xxxxxxxx)。

2

发起请求

在请求头中添加 X-API-Key,或通过查询参数 ?api_key= 传入。

curl -X POST https://yunsilu.net/api/v1/geo-simulate \
  -H "X-API-Key: ysl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"brand":"海底捞","industry":"火锅","url":"haidilao.com"}'
3

处理响应

所有API返回统一的 JSON 结构,包含 successdatausage 字段。

{
  "success": true,
  "data": { ... },
  "usage": {
    "ai_calls_used": 1,
    "ai_calls_limit": 200,
    "basic_calls_used": 0,
    "basic_calls_limit": 1000
  }
}

API 端点

所有端点基础URL:https://yunsilu.net/api/v1 | 认证方式:X-API-Key 请求头

🔥 AI 搜索模拟(核心能力)

POST /geo-simulate 模拟5大AI平台推荐 AI调用

输入品牌与行业信息,系统自动生成泛查询问题,模拟ChatGPT/文心一言/Kimi/豆包/DeepSeek五大平台的推荐结果。核心逻辑:用户不提品牌名时,AI会不会主动推荐你。

参数类型必填说明
brandstring必填品牌名称,如"海底捞"
industrystring必填行业名称,如"火锅"
urlstring选填品牌官网URL
keywordsstring选填关键词,逗号分隔
competitorsstring选填竞品名称,逗号分隔

响应示例:

{
  "success": true,
  "data": {
    "brand": "海底捞",
    "industry": "火锅",
    "score": 3,
    "total_platforms": 5,
    "results": {
      "chatgpt": { "recommended": true, "reason": "..." },
      "wenxin": { "recommended": false, "reason": "..." },
      "kimi": { "recommended": true, "reason": "..." },
      "doubao": { "recommended": true, "reason": "..." },
      "deepseek": { "recommended": false, "reason": "..." }
    }
  }
}

📊 GEO 健康检测

POST /geo-audit 5维度GEO健康评分 AI调用

从AI可发现性、内容结构化、竞品差距、信源权威度、品牌一致性五个维度评估GEO健康度,并输出优化清单。

参数类型必填说明
brandstring必填品牌名称
urlstring必填品牌官网URL
industrystring选填行业名称

响应示例:

{
  "success": true,
  "data": {
    "brand": "海底捞",
    "score": 82,
    "dimensions": {
      "ai_discoverability": 85,
      "content_structure": 78,
      "competitor_gap": 80,
      "authority": 75,
      "brand_consistency": 90
    },
    "issues": ["缺少llms.txt文件", "robots.txt屏蔽AI爬虫"],
    "suggestions": ["添加llms.txt", "修改robots.txt允许AI爬取"]
  }
}

🔍 AI 可见性检测

POST /ai-check 品牌AI搜索可见性 AI调用

检测品牌在AI搜索结果中的可见性评分,返回各平台引用情况。

参数类型必填说明
keywordstring必填品牌名或关键词
urlstring选填品牌官网URL

🆕 AI引用追踪 + 知识图谱(黑科技)

POST /citation-track AI引用追踪——品牌被AI引用了吗?引用了什么? AI调用 NEW

输入品牌名,系统自动查询5大AI平台(ChatGPT/DeepSeek/豆包/文心一言/通义千问),追踪每个平台是否引用了你的品牌、引用了哪段原文、竞品被引用了几次。这是GEO优化的核心指标——光有网站不够,还得看AI会不会"说到你"。

参数类型必填说明
brandstring必填品牌名称,如"海底捞"
urlstring选填品牌官网URL
industrystring选填行业名称,如"火锅"
competitorsstring选填竞品名称,逗号分隔

响应示例:

{
  "success": true,
  "data": {
    "brand": "海底捞",
    "citation_score": 80,
    "total_platforms": 5,
    "brand_mentions": 4,
    "mention_rate": "80.0%",
    "platforms": [
      {
        "platform": "ChatGPT",
        "brand_mentioned": true,
        "citation_snippet": "...海底捞以其出色的服务体验闻名...",
        "competitors_mentioned": ["呷哺呷哺"]
      }
    ],
    "competitor_comparison": [
      { "name": "呷哺呷哺", "platforms_mentioned": 3, "mention_rate": "60.0%" }
    ],
    "recommendations": ["品牌在AI平台中的引用表现优秀,建议持续保持内容更新"]
  }
}
POST /knowledge-graph 知识图谱评分——AI知识库里有没有你? AI调用 NEW

深度检测你的品牌在AI知识图谱中的位置:AI是否把你的品牌识别为独立实体?你的品牌和哪些关键词/行业/场景关联?AI在回答行业问题时会不会主动联想到你?你的网站结构化数据做得怎么样?返回ABCD四档评分和详细优化建议。

参数类型必填说明
brandstring必填品牌名称,如"海底捞"
urlstring选填品牌官网URL(提供后会检测结构化数据)
industrystring选填行业名称

响应示例:

{
  "success": true,
  "data": {
    "brand": "海底捞",
    "knowledge_graph_score": 75,
    "grade": "B",
    "entity_recognition": {
      "is_known_entity": true,
      "entity_type": "品牌",
      "description": "海底捞是中国知名火锅连锁品牌...",
      "trust_level": "高",
      "data_freshness": "较新"
    },
    "semantic_association": {
      "strength": 8,
      "top_of_mind": true,
      "reason": "火锅行业头部品牌,用户提及火锅时高频联想",
      "content_gaps": ["海外门店覆盖信息不足", "数字化转型案例缺失"]
    },
    "related_keywords": ["火锅", "服务体验", "连锁餐饮"],
    "related_industries": ["餐饮", "连锁", "食品"],
    "related_scenarios": ["朋友聚餐", "家庭聚会", "商务宴请"],
    "competitors": ["呷哺呷哺", "巴奴", "小龙坎"],
    "structure_score": 70,
    "structure_issues": ["缺少JSON-LD结构化数据"],
    "recommendations": ["品牌已被AI识别,但关联度不强..."]
  }
}

⚙️ 基础检测(普通调用)

POST /meta-check Meta标签检测 普通调用

检测网页的Title、Description、Keywords等Meta标签规范性。

参数类型必填说明
urlstring必填待检测的网页URL
POST /robots-check Robots & AI爬虫检测 普通调用

检测robots.txt配置,判断是否屏蔽了AI爬虫(GPTBot/ClaudeBot等)。

参数类型必填说明
urlstring必填网站首页URL
GET /llms-txt-generator 生成llms.txt 普通调用

根据网站内容自动生成llms.txt文件,帮助AI模型更好地理解网站。

参数类型必填说明
urlstring必填网站URL(query参数)
GET /index-check 搜索引擎索引量查询 普通调用

查询域名在各大搜索引擎的索引收录数量。

参数类型必填说明
domainstring必填查询域名(query参数)

错误码参考

HTTP状态码错误码说明
401MISSING_API_KEY缺少API Key,请在请求头添加 X-API-Key
401INVALID_API_KEYAPI Key无效或已停用
429QUOTA_EXCEEDED调用额度已用完,请升级套餐或购买加量包
429RATE_LIMITED请求频率超限,请降低调用频率
400MISSING_PARAM缺少必填参数
500INTERNAL_ERROR服务器内部错误,请稍后重试

每个响应都包含 X-RateLimit-AI-Used / X-RateLimit-AI-Limit / X-RateLimit-Basic-Used / X-RateLimit-Basic-Limit 响应头,方便你实时监控额度。