Ai Looker 开放接口文档

采用标准 RESTful 设计与统一响应结构，帮助开发者将 Ai Looker 的数据采集能力无缝集成到自有系统。以下为当前开放的接口列表与调用说明。

接入说明

所有接口均通过 HTTPS 调用，请求与响应均使用 UTF-8 编码。请在下方基础地址后拼接具体接口路径进行请求。

基础地址 Base URL

https://api.ailookerhub.com

请求协议

HTTPS

请求格式

Query / JSON

响应格式

application/json

字符编码

UTF-8

通用响应结构

所有接口均返回统一的 JSON 结构，通过 code 字段判断请求是否成功（0 表示成功），业务数据统一放置在 data 字段中，提示信息位于 message 字段。

{
  "code": 0,
  "data": { },
  "message": "操作成功"
}

code 字段说明

状态码	说明
0	请求成功
400	请求参数错误
401	未授权或鉴权失败
404	资源不存在
500	服务器内部错误

1、推送采集数据

向指定 AI 平台推送采集任务，服务端接收后异步处理。该接口支持配置回调地址（callbackUrl），采集完成后系统会主动将结果推送到指定地址，无需轮询查询。

POST/app/crawl/data/task

请求参数

参数名	位置	类型	必填	说明
sourceName	Body	string	是	来源名称，用于获取对应的签名密钥
platform	Body	string	是	采集平台，如 doubao、deepseek、yuanbao 等
mode	Body	string	是	模式：normal（普通）、think（深度思考）
prompt	Body	string	是	提问词内容
taskDataType	Body	string	是	返回数据类型：markdown、html
sign	Body	string	是	校验参数：MD5(prompt + 日期(YYYY-MM-DD) + 密钥)
callbackUrl	Body	string	否	回调地址。配置后，采集完成时系统会将结果 POST 到该地址

请求示例

cURL

curl --location "https://api.ailookerhub.com/app/crawl/data/task" \
  --header "Content-Type: application/json" \
  --data '{
    "sourceName": "your-source-name",
    "platform": "doubao",
    "mode": "think",
    "prompt": "谁最好看",
    "taskDataType": "markdown",
    "sign": "3628b219c2e5e28a8afa97fe8b8b57f1",
    "callbackUrl": "https://your-domain.com/callback"
  }'

响应字段

字段名	类型	说明
code	integer	状态码，0 表示成功
data	object	业务数据
data.taskId	string	任务 ID，用于查询采集结果
message	string	提示信息

响应示例

JSON

{
  "code": 0,
  "data": {
    "taskId": "268acea6fad94812a4ee9b52c3b9d68a"
  },
  "message": "任务已接收，正在处理"
}

2、根据任务 ID 获取数据

根据推送接口返回的任务 ID 查询采集结果，返回任务状态、平台信息、回答内容与引用来源列表。

GET/api/app/crawl/data/query