文档网络搜索 API
网络搜索 API
实时互联网搜索,支持多引擎
概览
GET /v1/info/search 提供实时互联网搜索,自动使用高质量搜索引擎,返回结构化的搜索结果。
什么时候用我
- 查询特定话题/事件:用户问"最近 AI 行业的新闻"、"特斯拉自动驾驶最新进展"
- 查询股票相关消息:调用
/v1/finance/stock获取行情后,用 search 补充新闻舆情 - 训练数据外的信息:AI Agent 需要了解最近发生的事,超出大模型训练截止日期的信息
- 缩短时间窗:
recency=oneWeek拿最近一周;oneDay拿当天 - vs
/v1/info/news:search 是按关键词搜全网(精准但慢),news 是按预设分类拉取(快但宽泛)
请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
q | string | 是 | - | 搜索关键词 |
count | int | 否 | 10 | 返回结果数量(1-50) |
recency | string | 否 | noLimit | 时间范围:oneDay/oneWeek/oneMonth/oneYear/noLimit |
请求示例
curl -H "X-API-Key: sk_gapi_xxxxx" \
"https://api.groundapi.net/v1/info/search?q=半导体行业最新动态&count=10"响应字段
| 字段 | 说明 |
|---|---|
query | 搜索关键词 |
result_count | 结果数量 |
results[].title | 网页标题 |
results[].link | 网页链接 |
results[].snippet | 内容摘要 |
results[].source | 来源网站 |
results[].publish_date | 发布日期 |
计费
$0.02/次。每月前 500 次免费。
1 个月前更新