认证方式
所有 API 请求需在 HTTP Header 中携带 Authorization: Bearer <API_KEY>。API Key 在控制台「账户设置 → API Key」中生成。
curl https://api.flyai66.top/v1/monitoring?keyword=GEO \
-H "Authorization: Bearer $FLYAI_API_KEY"速率限制
| 套餐 | 每分钟 | 每天 |
|---|---|---|
| 专业版 | 60 次 | 1,000 次 |
| 企业版 | 600 次（可协商） | 不限量 |
响应头包含 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset 字段。
接口列表
POST
/v1/diagnosis提交 AI 搜索可见性诊断任务，返回 100+ 维度诊断报告。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| urls | string[] | 是 | 待诊断的 URL 列表，最多 500 个 |
| keywords | string[] | 否 | 关注的关键词列表，最多 20 个 |
| engines | string[] | 否 | 目标引擎，默认全部 12+ 引擎 |
POST
/v1/structure将 Markdown/富文本内容转换为引擎友好的结构化格式。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| content | string | 是 | Markdown 或 HTML 内容 |
| entity_name | string | 是 | 品牌实体名 |
| format | string | 否 | 输出格式：markdown / json-ld |
POST
/v1/schema生成指定类型的 Schema.org JSON-LD。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | string | 是 | Schema 类型：Organization / WebSite / SoftwareApplication / FAQPage / BreadcrumbList / Article |
| data | object | 是 | Schema 字段数据 |
GET
/v1/monitoring查询品牌在 12+ 生成式引擎中的引用与提及数据。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| keyword | string | 是 | 查询关键词 |
| engines | string[] | 否 | 目标引擎 |
| date_from | string | 否 | 开始日期 YYYY-MM-DD |
| date_to | string | 否 | 结束日期 YYYY-MM-DD |
诊断接口 curl 示例
curl -X POST https://api.flyai66.top/v1/diagnosis \
-H "Authorization: Bearer $FLYAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.flyai66.top", "https://www.flyai66.top/product"],
"keywords": ["GEO 工具", "AI 搜索优化"]
}'错误码
| 状态码 | 错误码 | 说明 |
|---|---|---|
| 400 | invalid_request | 请求参数错误 |
| 401 | unauthorized | API Key 无效或缺失 |
| 403 | forbidden | 套餐不支持该接口 |
| 429 | rate_limited | 超出速率限制 |
| 500 | internal_error | 服务器内部错误 |