快速开始
发出第一个网页搜索请求并读取结果。
Web Search 目前通过 COM 站点与香港 API 提供服务。也可以先登录 Web Search 试验场，输入关键词，直接浏览可点击的搜索结果。
准备凭证
在 API 密钥设置 创建 API key 并获取 project id，分别放入 X-API-Key 和 X-Project-Id 请求头；两者必须属于同一项目。API Key 应保存在服务端，不要写入网页代码或公开仓库。
搜索网页
BASE_URL='https://api.lexmount.com'
API_KEY='<your-api-key>'
PROJECT_ID='<your-project-id>'
curl -sS "$BASE_URL/v1/search" \
-H 'Content-Type: application/json' \
-H "X-API-Key: $API_KEY" \
-H "X-Project-Id: $PROJECT_ID" \
--data '{
"query": "PostgreSQL replication",
"limit": 20,
"timeout_ms": 10000
}'这个请求最多返回 20 条去重结果。未填写 limit 时，API 默认上限为 10 条。
从 results 读取网页链接、标题和摘要，returned 为实际返回条数。partial 响应中的结果可以使用，但可能不完整；partial 的空数组不能视为确认没有相关网页。完整示例见 响应示例。
设置语言、地区和域名
curl -sS "$BASE_URL/v1/search" \
-H 'Content-Type: application/json' \
-H "X-API-Key: $API_KEY" \
-H "X-Project-Id: $PROJECT_ID" \
--data '{
"query": "PostgreSQL 复制",
"limit": 20,
"language": "zh-CN",
"region": "CN",
"filters": {
"include_domains": [
"postgresql.org"
]
}
}'语言和地区是搜索偏好，不保证每条结果都属于指定语言或地区。filters.include_domains 是硬筛选，只保留匹配域名及其子域名的结果。
设置时间预算
timeout_ms 默认 10000 毫秒，范围为 1000–60000。客户端超时应大于这个值，为请求体传输、网络延迟和接收响应留出时间。
遇到 HTTP 503 时也应读取 JSON 响应体。反馈问题时，请保留响应中的 request_id 或 X-Request-ID 响应头。
HTTP 401 请检查 API Key，403 请检查项目是否匹配及访问来源是否符合服务区域限制。region 只影响搜索偏好，不改变 API 的访问区域限制。完整参数与错误说明见 搜索接口。