Appearance
搜索一页 Google 搜索结果
方法:
POST返回: Google 搜索结果列表（抽取后的 JSON 数据）
说明：文档中的示例均以 国内入口 为例，如需使用国外入口，请将接口地址替换即可。
参数说明
| 参数 | 是否必须 | 默认值 | 说明 |
|---|---|---|---|
q | 是 | 无 | 搜索关键词 |
gl | 否 | US | 国家/地区代码，例如 CN 或 US |
hl | 否 | en | 界面语言，例如 zh-cn 或 en |
range | 否 | None | 时间范围，可选：hour、day、week、month、year |
page | 否 | 1 | 页码 |
测试用例
bash
curl -H "Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" 'https://api.serp.hk/serp/google/search/advanced' -X POST -d '{"q":"apple"}' --compressed返回结果
json
{
"code": 0,
"msg": "成功",
"result": {
"general": {
"engine": "google",
"page":1,
"query": "apple",
"type": "search"
},
"organic": [
{
"display_link": "www.apple.com",
"link": "https://www.apple.com/",
"rank": 1,
"sitelinks": [
{
"link": "https://www.apple.com/iphone/",
"title": "iPhone"
},
{
"link": "https://www.apple.com/watch/",
"title": "Watch"
},
{
"link": "https://www.apple.com/mac/",
"title": "Mac"
},
{
"link": "https://www.apple.com/ipad/",
"title": "iPad"
},
{
"link": "https://support.apple.com/",
"title": "Support"
},
{
"link": "https://www.apple.com/airpods/",
"title": "AirPods"
}
],
"snippet": "Discover the innovative world of Apple and shop everything iPhone, iPad, Apple Watch, Mac, and Apple TV, plus explore accessories, entertainment, ...",
"title": "Apple"
},
{
"display_link": "www.icloud.com",
"link": "https://www.icloud.com/",
"rank": 3,
"snippet": "Log in to iCloud to access your photos, mail, notes, documents and more. Sign in with your Apple Account or create a new account to start using Apple services.",
"title": "iCloud"
},
{
"display_link": "en.wikipedia.org › wiki › Apple_Inc",
"link": "https://en.wikipedia.org/wiki/Apple_Inc.",
"rank": 4,
"snippet": "Apple Inc. is an American multinational technology company headquartered in Cupertino, California, in Silicon Valley, best known for its consumer electronics, ...",
"title": "Apple Inc. - Wikipedia"
},
{
"display_link": "www.instagram.com › apple",
"link": "https://www.instagram.com/apple/",
"rank": 5,
"snippet": "Rangoli's got rhythm. Commissioned by Apple. For Diwali, @howareyoufeeling.studio reimagined rangoli through dance, music and the most vibrant colors.",
"title": "apple • Instagram photos and videos"
},
{
"display_link": "appleinsider.com",
"link": "https://appleinsider.com/",
"rank": 6,
"snippet": "For Apple News, Rumors, Reviews, Prices, and Deals, trust AppleInsider. Serving Apple product enthusiasts since 1997.",
"title": "AppleInsider: Apple News, Rumors, Reviews, Prices & Deals"
}
],
"people_also_ask": [
{
"answer": "The iPhone 17 Pro Max, the larger variant of Apple's Pro phone that launches today along with the iPhone 17, 17 Pro and iPhone Air, costs $2,000 if buyers choose the version with two terabytes (2TB) of storage.$2000 for a phone? Apple says yes | CNN Businesswww.cnn.com › 2025/09/19 › tech › app...More results",
"rank": 2,
"reference": [
{
"display_link": "www.cnn.com › 2025/09/19 › tech › app...",
"link": "https://www.cnn.com/2025/09/19/tech/apple-iphone-17-pro-max-2tb-2000-dollars",
"title": "$2000 for a phone? Apple says yes | CNN Business"
}
],
"title": "What iPhone is $2000?"
}
],
"people_also_search_for": [
{
"rank": 7,
"text": "Apple USA"
},
{
"rank": 7,
"text": "Apple i d"
},
{
"rank": 7,
"text": "Apple Store"
},
{
"rank": 7,
"text": "Apple login"
},
{
"rank": 7,
"text": "Apple fruit"
},
{
"rank": 7,
"text": "Apple logo"
}
]
}
}结果字段说明
| 字段 | 说明 |
|---|---|
| general | 通用信息（如搜索关键字、搜索引擎等） |
| ai_overview | AI概览模块，Google AI生成的搜索结果摘要，基于多个网页源整合信息，为用户查询提供直接、综合性的答案 |
| answer_box | 搜索结果中的直接答案模块，用于回答有明确答案的问题，如股票、价格、时间等，包含答案文本及其引用信息。 |
| knowledge_graph | 知识图谱模块，例如公司、人物、地点等结构化展示信息 |
| organic | 自然搜索结果列表，每项包含网页标题、摘要、URL 等信息 |
| people_also_ask | “people also ask”模块，展示相关提问及其简要回答 |
| people_also_search_for | “people also search”模块，展示相关关键词推荐 |
| top_stories | 热门新闻模块，包括标题、来源、时间、链接等内容 |
错误码说明
| 错误码 | 说明 |
|---|---|
| 3101 | 参数错误 |
| 3102 | 访问失败，请重试 |
| 3103 | 未授权 |
| 3104 | 超过访问速率限制 |
| 3199 | 运行时错误 |