# 搜索

`POST /v1/search`

按查询返回排序后的网页结果。

## 请求体

- `query` (string): 必填。 要搜索或研究的内容。不能为空，最多 2,000 个字符。

- `limit` (integer): 返回结果数，1 到 10。 默认值：10

- `published_after` (string): 只返回在此时间及之后发布的结果（ISO 8601，UTC）。

- `published_before` (string): 只返回在此时间之前发布的结果（ISO 8601，UTC）。

## 响应

- `results` (object[]): 排序后的结果；没有匹配时为空。

- `results[].title` (string): 结果标题。

- `results[].url` (string): 网页地址。

- `results[].snippet` (string): 网页摘要（如有）。

- `results[].published_at` (string): 发布时间（如有）。

## 请求示例

```bash
curl "https://api.arex-research.com/v1/search" \
  -H "Authorization: Bearer $AREX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"latest AI agent research","limit":5}'
```

## 响应 200

```json
{
  "results": [
    {
      "title": "AI agent evaluation",
      "url": "https://example.com/research",
      "snippet": "An overview of approaches to evaluating AI agents.",
      "published_at": "2026-09-28T08:00:00.000Z"
    }
  ]
}
```

另请参阅: [身份验证](/platform/docs/concepts/authentication.md?locale=zh) · [错误处理](/platform/docs/concepts/errors.md?locale=zh) · [限流](/platform/docs/concepts/rate-limits.md?locale=zh)