JuCode 文档
ApiTools

网页搜索

搜索网页,返回标题、地址、摘要与发布日期。响应格式由网关统一,与所用引擎无关。 `engine` 默认 `auto`:网关按可用性选择引擎,某个引擎故障时自动换用另一个。 响应里的 `engine` 是实际应答的引擎。 每次成功调用按次扣费,失败不扣费。

POST
/tools/v1/search

搜索网页,返回标题、地址、摘要与发布日期。响应格式由网关统一,与所用引擎无关。

engine 默认 auto:网关按可用性选择引擎,某个引擎故障时自动换用另一个。 响应里的 engine 是实际应答的引擎。

每次成功调用按次扣费,失败不扣费。

Authorization

AuthorizationBearer <token>

Authorization: Bearer sk-juc-...

前缀必须是恰好 Bearer (首字母大写 + 单个空格)。bearer、BEARER 或用制表符分隔都会被判为无效。

除 API Key 外,也接受 OAuth 设备访问令牌(仅限 oauth_access 类型的 JWT; 普通网页会话令牌会被拒绝)。

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/tools/v1/search" \  -H "Content-Type: application/json" \  -d '{    "query": "rust async runtime comparison"  }'
{  "object": "web.search",  "engine": "parallel",  "query": "rust async runtime comparison",  "results": [    {      "title": "Async Rust runtimes compared",      "url": "https://example.com/runtimes",      "snippet": "Tokio remains the default choice ...",      "published_at": "2026-08-14"    }  ]}