跳转到主要内容
POST
https://api.ppinfra.com
/
v3
/
web-search
Web Search API
curl --request POST \
  --url https://api.ppinfra.com/v3/web-search
从全网搜索任何网页信息和网页链接，结果准确、摘要完整，更适合 AI 使用。 搜索结果包括网页、图片
  • 网页包括 name、url、snippet、summary、siteName、siteIcon、datePublished 等信息
  • 图片包括 contentUrl、hostPageUrl、width、height 等信息
可配置搜索时间范围、是否显示摘要，支持按分页获取更多结果。

​
请求头

​
Content-Type
string
required
枚举值: application/json
​
Authorization
string
required
Bearer 身份验证格式，例如：Bearer {{API 密钥}}。

​
请求体

​
query
string
required
用户的搜索词。
​
freshness
string
搜索指定时间范围内的网页。可填值：
  • noLimit，不限（默认）
  • oneDay，一天内
  • oneWeek，一周内
  • oneMonth，一个月内
  • oneYear，一年内
  • YYYY-MM-DD..YYYY-MM-DD，搜索日期范围，例如：“2025-01-01..2025-04-06”
  • YYYY-MM-DD，搜索指定日期，例如：“2025-04-06”
推荐使用 noLimit。搜索算法会自动进行时间范围的改写，效果更佳。如果指定时间范围，很有可能出现时间范围内没有相关网页的情况，导致找不到搜索结果。
​
summary
boolean
是否显示文本摘要。可填值：
  • true，显示
  • false，不显示（默认）
​
include
string
指定搜索的网站范围。多个域名使用 | 或 , 分隔，最多不能超过20个可填值：
  • 根域名
  • 子域名
例如：qq.com|m.163.com
​
exclude
string
排除搜索的网站范围。多个域名使用 | 或 , 分隔，最多不能超过20个可填值：
  • 根域名
  • 子域名
例如：qq.com|m.163.com
​
count
int
返回结果的条数（实际返回结果数量可能会小于count指定的数量）。
  • 可填范围：1-50，最大单次搜索返回50条
  • 默认为10

​
响应

​
SearchData
object
搜索响应的主要数据对象
​
WebSearchQueryContext
object
搜索查询的上下文信息
​
WebSearchWebPages
object
搜索的网页结果集合
​
WebPageValue
object
单个网页搜索结果的详细信息
​
WebSearchImages
object
搜索的图片结果集合
​
WebSearchVideos
object
搜索的视频结果集合
​
ImageValue
object
单个图片搜索结果的详细信息
​
VideoValue
object
单个视频搜索结果的详细信息
​
Creator
object
创建者信息
​
Publisher
object
发布者信息
​
Thumbnail
object
缩略图信息
​
RankingResponse
object
排名响应信息
​
Mainline
object
主线排名信息
​
MainlineItem
object
主线项目信息
​
MainlineItemValue
object
主线项目值信息