跳转到主要内容
POST
搜索可运行接口
选择候选接口后,先检查接口再运行。结果不合适时请更换关键词;低分或已到末页,不能证明没有相应能力。

请求体

application/json
use_case
string
必填

每次搜索必填。保留用户原话及研究对象,说明本次搜索背后的需求,例如公司、域名、股票代码、地点或主题。请求较长时可缩短,不要改写含义。

Minimum string length: 1
query
string | null

描述所需数据的关键词。省略或留空时,浏览当前 API Key Policy 允许的全部接口。

limit
integer | null

每页最多结果数,默认为 5,最大为 20。

必填范围: 1 <= x <= 20
cursor
string | null

上次响应中的 next_cursor。查询词必须保持相同;使用其他查询的游标会返回 400。

task_id
string | null

本次搜索所属 Task。不带 task_id 的搜索会新建 Task,响应返回其 task_id。同一项工作的后续搜索、检查和运行均应传入,接受任意稳定字符串。

metadata

可选追踪字段,随 Run 返回,也可用于筛选。不会发送给数据提供商,也不影响路由、价格或幂等。

  • 最多 20 个键:小写字母、数字和下划线,以字母开头,最长 40 个字符。
  • 值:长度为 1–500 的字符串。
  • user_id:终端用户的不透明 ID,不得使用邮箱或姓名。

无效条目整体丢弃,不截断。请求继续执行,Run 返回实际保存的字段。

响应

成功

data
object[]
必填

按相关性排序,并按当前 API Key Policy 筛选的接口摘要。价格不影响排序。

next_cursor
string | null
必填

将此值作为 cursor 读取下一页。null 表示没有更多结果。

total
integer
必填

所有页中已排序候选的总数。

必填范围: x >= 0
task_id
string
必填

本次搜索关联的 Task,即传入的值;未传入时新建。对于同一项工作,后续每次搜索、检查和运行都应传回此值。

client
object