- 网页包括 name、url、snippet、summary、siteName、siteIcon、datePublished 等信息
- 图片包括 contentUrl、hostPageUrl、width、height 等信息
可配置搜索时间范围、是否显示摘要,支持按分页获取更多结果。
请求头
枚举值:
application/json
Bearer 身份验证格式,例如:Bearer {{API 密钥}}。
请求体
用户的搜索词。
搜索指定时间范围内的网页。可填值:
noLimit
,不限(默认)oneDay
,一天内oneWeek
,一周内oneMonth
,一个月内oneYear
,一年内YYYY-MM-DD..YYYY-MM-DD
,搜索日期范围,例如:“2025-01-01..2025-04-06”YYYY-MM-DD
,搜索指定日期,例如:“2025-04-06”
推荐使用
noLimit
。搜索算法会自动进行时间范围的改写,效果更佳。如果指定时间范围,很有可能出现时间范围内没有相关网页的情况,导致找不到搜索结果。是否显示文本摘要。可填值:
true
,显示false
,不显示(默认)
指定搜索的网站范围。多个域名使用
|
或 ,
分隔,最多不能超过20个可填值:- 根域名
- 子域名
排除搜索的网站范围。多个域名使用
|
或 ,
分隔,最多不能超过20个可填值:- 根域名
- 子域名
返回结果的条数(实际返回结果数量可能会小于count指定的数量)。
- 可填范围:1-50,最大单次搜索返回50条
- 默认为10
响应
搜索响应的主要数据对象
搜索查询的上下文信息
搜索的网页结果集合
单个网页搜索结果的详细信息
搜索的图片结果集合
搜索的视频结果集合
单个图片搜索结果的详细信息
单个视频搜索结果的详细信息
创建者信息
发布者信息
缩略图信息
排名响应信息
主线排名信息
主线项目信息
主线项目值信息