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>"
}
}
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>"
}
}
application/json
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个可填值:Show properties
dateLastCrawled
值(例如:2025-02-23T08:18:30Z)实际上要表达的是 UTC+8 北京时间2025-02-23 08:18:30,并非UTC时间。实际应用中请使用 datePublished
字段,或将 “2025-02-23T08:18:30Z” 替换成 “2025-02-23T08:18:30+08:00”,即得到正确的UTC+8时间,可以使用 datetime 函数正确解析。Show properties
Show properties