curl --request POST \
--url https://api.aibase.cn/v1/openapi/tasks \
--header "AIBase-API-Key: ${AIBASE_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"apiCode": "geo.checker",
"data": {
"url": "https://www.example.com/product",
"title": "示例品牌官网",
"platforms": "deepseek,aliyun",
"questions": "[\"示例品牌怎么样\",\"示例品牌官网是哪个\",\"示例品牌有什么优势\"]"
}
}'
import os
import time
import requests
api_key = os.environ["AIBASE_API_KEY"]
headers = {
"AIBase-API-Key": api_key,
"Content-Type": "application/json",
}
# 1. 提交任务
res = requests.post(
"https://api.aibase.cn/v1/openapi/tasks",
headers=headers,
json={
"apiCode": "geo.checker",
"data": {
"url": "https://www.example.com/product",
"title": "示例品牌官网",
"platforms": "deepseek,aliyun",
"questions": '["示例品牌怎么样", "示例品牌优势有哪些"]',
},
},
timeout=30,
)
res.raise_for_status()
task_id = res.json()["data"]["taskId"]
print("任务已提交，taskId:", task_id)
# 2. 轮询获取结果
while True:
time.sleep(10)
query_res = requests.get(
f"https://api.aibase.cn/v1/openapi/tasks/{task_id}",
headers={"AIBase-API-Key": api_key},
timeout=30,
)
payload = query_res.json()
status = payload["data"]["status"]
if status == 2:
print("检测成功！推广链接被引用结果:")
print(payload["data"]["result"])
break
elif status != 1:
raise RuntimeError(f"任务异常终止，status: {status}")
{
"code": 200,
"msg": "成功",
"data": {
"requestId": "599b2f8f39078d",
"taskId": "task_d77143abc87642d4842ff588197faa89"
},
"timeStamp": 1789550182642
}
GEO 推广链接检测
检测指定推广网页在多个 AI 平台回答中的引用情况、同源引用率、来源文章与域名聚合表现。
POST
/
v1
/
openapi
/
tasks
curl --request POST \
--url https://api.aibase.cn/v1/openapi/tasks \
--header "AIBase-API-Key: ${AIBASE_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"apiCode": "geo.checker",
"data": {
"url": "https://www.example.com/product",
"title": "示例品牌官网",
"platforms": "deepseek,aliyun",
"questions": "[\"示例品牌怎么样\",\"示例品牌官网是哪个\",\"示例品牌有什么优势\"]"
}
}'
import os
import time
import requests
api_key = os.environ["AIBASE_API_KEY"]
headers = {
"AIBase-API-Key": api_key,
"Content-Type": "application/json",
}
# 1. 提交任务
res = requests.post(
"https://api.aibase.cn/v1/openapi/tasks",
headers=headers,
json={
"apiCode": "geo.checker",
"data": {
"url": "https://www.example.com/product",
"title": "示例品牌官网",
"platforms": "deepseek,aliyun",
"questions": '["示例品牌怎么样", "示例品牌优势有哪些"]',
},
},
timeout=30,
)
res.raise_for_status()
task_id = res.json()["data"]["taskId"]
print("任务已提交，taskId:", task_id)
# 2. 轮询获取结果
while True:
time.sleep(10)
query_res = requests.get(
f"https://api.aibase.cn/v1/openapi/tasks/{task_id}",
headers={"AIBase-API-Key": api_key},
timeout=30,
)
payload = query_res.json()
status = payload["data"]["status"]
if status == 2:
print("检测成功！推广链接被引用结果:")
print(payload["data"]["result"])
break
elif status != 1:
raise RuntimeError(f"任务异常终止，status: {status}")
{
"code": 200,
"msg": "成功",
"data": {
"requestId": "599b2f8f39078d",
"taskId": "task_d77143abc87642d4842ff588197faa89"
},
"timeStamp": 1789550182642
}
GEO 推广链接检测用于检测指定网页链接（URL）在主流大模型（AI 平台）回答中的被引用情况。接口支持检测 URL 是否被 AI 平台作为可信来源链接推荐引用（同源引用）、引用的频次、来源文章及域名聚合分析。
执行模式：ASYNC · 异步。
本接口采用异步任务模式：向统一入口提交请求后，平台返回
requestId 和 taskId；随后使用 taskId 轮询 异步任务查询接口（建议每隔 10 秒查询一次）获取最终结果。接口速查
| 项目 | 当前接口约定 |
|---|---|
| 接口状态 | 已上线 |
| 请求方式 | POST |
| 请求地址 | https://api.aibase.cn/v1/openapi/tasks |
| 业务标识 | geo.checker |
| 执行模式 | ASYNC · 异步（需轮询结果） |
| 身份认证 | Header AIBase-API-Key |
| 请求格式 | application/json |
请求头
string
required
AIBase 开放平台 API Key，例如
AIBase_xxx。请仅在服务端保存和使用。string
required
固定为
application/json。string
可选的客户端请求追踪标识。
请求体
string
required
固定为
geo.checker。object
required
当前业务接口的参数对象。
string
required
待检测的目标网页 URL。必须是以
http:// 或 https:// 开头且能合法解析出 host 的完整链接。string
required
检测标题或品牌词，不能为空。注意：不能是合法 URL 格式，也不能直接包含前面提交的
url，否则接口会返回参数校验错误（错误码 4002）。string
required
参与检测的 AI 平台标识，为英文逗号分隔的字符串，例如
"deepseek,aliyun"。string
自定义检测问题列表。注意参数类型为字符串，内容必须为 JSON 字符串数组格式，例如
"[\"示例品牌怎么样\",\"示例品牌官网是哪个\"]"。不传时系统将自动生成对应问题。curl --request POST \
--url https://api.aibase.cn/v1/openapi/tasks \
--header "AIBase-API-Key: ${AIBASE_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{
"apiCode": "geo.checker",
"data": {
"url": "https://www.example.com/product",
"title": "示例品牌官网",
"platforms": "deepseek,aliyun",
"questions": "[\"示例品牌怎么样\",\"示例品牌官网是哪个\",\"示例品牌有什么优势\"]"
}
}'
import os
import time
import requests
api_key = os.environ["AIBASE_API_KEY"]
headers = {
"AIBase-API-Key": api_key,
"Content-Type": "application/json",
}
# 1. 提交任务
res = requests.post(
"https://api.aibase.cn/v1/openapi/tasks",
headers=headers,
json={
"apiCode": "geo.checker",
"data": {
"url": "https://www.example.com/product",
"title": "示例品牌官网",
"platforms": "deepseek,aliyun",
"questions": '["示例品牌怎么样", "示例品牌优势有哪些"]',
},
},
timeout=30,
)
res.raise_for_status()
task_id = res.json()["data"]["taskId"]
print("任务已提交，taskId:", task_id)
# 2. 轮询获取结果
while True:
time.sleep(10)
query_res = requests.get(
f"https://api.aibase.cn/v1/openapi/tasks/{task_id}",
headers={"AIBase-API-Key": api_key},
timeout=30,
)
payload = query_res.json()
status = payload["data"]["status"]
if status == 2:
print("检测成功！推广链接被引用结果:")
print(payload["data"]["result"])
break
elif status != 1:
raise RuntimeError(f"任务异常终止，status: {status}")
第一步：提交任务响应
提交后服务端即时返回任务标识：{
"code": 200,
"msg": "成功",
"data": {
"requestId": "599b2f8f39078d",
"taskId": "task_d77143abc87642d4842ff588197faa89"
},
"timeStamp": 1789550182642
}
第二步：最终结果字段说明（GET 查询返回）
轮询任务查询接口，当status = 2 时，data.result 包含以下推广链接检测结果结构：
object
required
任务基础信息对象。
string
required
检测记录 ID。
string
required
标准化后的检测目标 URL。
string
required
提交的检测标题或品牌词。
integer
百度 PC 权重（BR 值），未获取到时为
null。integer
百度收录状态：
1 已收录、2 未收录、null 未获取到。string
required
任务提交创建时间。
string
required
最近更新时间。
integer
required
检测处理状态。
integer
required
该 URL 被各 AI 回答引用的总次数（同源引用总计）。
integer
required
引用来源出现的总次数。
integer
required
参与检测的问题总数。
string
required
用户 ID。
string
required
实际完成检测的平台列表（JSON 数组字符串，例如
"[\"deepseek\",\"aliyun\"]"）。integer
required
问题生成类型：
2 系统默认生成问题、3 用户自定义问题。integer
综合评分（未产出时为
null）。object[]
required
平台维度统计结果列表，按
mentions 倒序排列。string
required
大模型平台编码。
string
required
平台处理状态：
pending、completed、failed。integer
required
该平台下命中同源引用的次数合计。
integer
required
该平台下全部引用来源出现次数合计。
object[]
required
该平台下各问题的详细检测结果。
string
required
检测问题文本。
string
required
问题处理状态：
completed、processing、pending 等。integer
required
该问题下同源来源的出现个数。
integer
required
该问题下所有引用来源出现次数。
object[]
required
引用来源明细列表（仅在问题
status = "completed" 时返回；未完成时为空数组）。string
required
来源文章标题。
string
required
来源文章网页链接。
boolean
required
是否为被检测 URL 自身（同源命中）：
true 表示同源命中。object[]
required
被引用来源文章聚合排行，按
count 倒序排列。string
required
来源文章标题。
string
required
来源文章 URL。
integer
required
被各大模型引用的总次数。
string
来源站点名称。
string
站点类型（如官网、权威媒体、百科等）。
object[]
required
被引用来源域名聚合排行，按
count 倒序排列。string
required
来源域名。
string
required
主域名。
integer
域名百度权重（BR 值），可能为
null。integer
required
该域名下所有来源页面被引用的总次数合计。
{
"baseData": {
"id": "123456789",
"url": "https://www.example.com/product",
"title": "示例品牌官网",
"rank": null,
"urlInclude": 1,
"createTime": "2026-09-15 10:00:00",
"updateTime": "2026-09-15 10:30:00",
"status": 1,
"mentionNum": 8,
"sourceNum": 12,
"questionNum": 10,
"userId": "10001",
"platforms": "[\"deepseek\",\"aliyun\"]",
"type": 3,
"score": 80
},
"platformList": [
{
"status": "completed",
"platform": "deepseek",
"mentions": 5,
"source": 7,
"questions": [
{
"question": "示例品牌怎么样",
"status": "completed",
"mentions": 2,
"source": 3,
"sources": [
{
"title": "示例品牌产品介绍",
"url": "https://www.example.com/product",
"urlSame": true
}
]
}
]
}
],
"urlCountList": [
{
"title": "示例品牌产品介绍",
"url": "https://www.example.com/product",
"count": 2,
"websiteName": "示例品牌官网",
"websiteType": "官网"
}
],
"domainCountList": [
{
"domain": "example.com",
"mainDomain": "example.com",
"rank": null,
"count": 2
}
]
}
接入注意事项
- 固定业务标识：
apiCode必须固定为geo.checker。 - URL 与 Title 校验规则：
url必须是以http://或https://开头且能合法解析出 host 的完整链接。title不能为空，不能是合法 URL 格式，且不能包含已提交的 url，否则校验失败并返回错误码 4002。
- 参数格式注意：
platforms为英文逗号分隔的字符串（如"deepseek,aliyun"），非数组对象。questions为字符串类型，其内容必须是 JSON 格式的字符串数组（如"[\"问题1\",\"问题2\"]"），不可直接传入原生 JSON Array。
- 两阶段轮询：接口为 ASYNC 异步模式，提交后请保存
taskId，并建议间隔 10 秒轮询任务查询接口。 - 来源明细可用性：
platformList[].questions[].sources仅在问题状态为completed时返回明细，其余状态下均为空数组。