POST
/
v3
/
web-search
Web Search API
curl --request POST \
  --url https://api.ppinfra.com/v3/web-search \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '{
  "query": "<string>",
  "freshness": "<string>",
  "summary": true,
  "include": "<string>",
  "exclude": "<string>",
  "count": 123
}'
{
  "SearchData": {
    "_type": "<string>",
    "queryContext": {},
    "webPages": {},
    "images": {},
    "videos": {}
  },
  "WebSearchQueryContext": {
    "originalQuery": "<string>"
  },
  "WebSearchWebPages": {
    "webSearchUrl": "<string>",
    "totalEstimatedMatches": 123,
    "value": [
      {}
    ],
    "someResultsRemoved": true
  },
  "WebPageValue": {
    "id": "<string>",
    "name": "<string>",
    "url": "<string>",
    "displayUrl": "<string>",
    "snippet": "<string>",
    "summary": "<string>",
    "siteName": "<string>",
    "siteIcon": "<string>",
    "datePublished": "<string>",
    "dateLastCrawled": "<string>",
    "cachedPageUrl": "<string>",
    "language": "<string>",
    "isFamilyFriendly": true,
    "isNavigational": true
  },
  "WebSearchImages": {
    "id": "<string>",
    "readLink": "<string>",
    "webSearchUrl": "<string>",
    "isFamilyFriendly": true,
    "value": [
      {}
    ]
  },
  "WebSearchVideos": {
    "id": "<string>",
    "readLink": "<string>",
    "webSearchUrl": "<string>",
    "isFamilyFriendly": true,
    "scenario": "<string>",
    "value": [
      {}
    ]
  },
  "ImageValue": {
    "webSearchUrl": "<string>",
    "name": "<string>",
    "thumbnailUrl": "<string>",
    "datePublished": "<string>",
    "contentUrl": "<string>",
    "hostPageUrl": "<string>",
    "contentSize": "<string>",
    "encodingFormat": "<string>",
    "hostPageDisplayUrl": "<string>",
    "width": 123,
    "height": 123,
    "thumbnail": {}
  },
  "VideoValue": {
    "webSearchUrl": "<string>",
    "name": "<string>",
    "description": "<string>",
    "thumbnailUrl": "<string>",
    "publisher": [
      {}
    ],
    "creator": {},
    "contentUrl": "<string>",
    "hostPageUrl": "<string>",
    "encodingFormat": "<string>",
    "hostPageDisplayUrl": "<string>",
    "width": 123,
    "height": 123,
    "duration": "<string>",
    "motionThumbnailUrl": "<string>",
    "embedHtml": "<string>",
    "allowHttpsEmbed": true,
    "viewCount": 123,
    "thumbnail": {},
    "allowMobileEmbed": true,
    "isSuperfresh": true,
    "datePublished": "<string>"
  },
  "Creator": {
    "name": "<string>"
  },
  "Publisher": {
    "name": "<string>"
  },
  "Thumbnail": {
    "height": 123,
    "width": 123
  },
  "RankingResponse": {
    "mainline": {}
  },
  "Mainline": {
    "items": [
      {}
    ]
  },
  "MainlineItem": {
    "answerType": "<string>",
    "value": {}
  },
  "MainlineItemValue": {
    "id": "<string>"
  }
}
从全网搜索任何网页信息和网页链接,结果准确、摘要完整,更适合 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
主线项目值信息