所有 Google 引擎共用同一个端点,更改 engine 参数即可切换返回的内容。
https://serp.shifter.io/v1?engine=<engine>&api_key=YOUR_API_KEY&q=<query>engine | 返回内容 | 关键参数 |
|---|---|---|
google | 自然搜索结果、广告、摘要、PAA、知识图谱 | q、location、gl、hl、device |
google_autocomplete | 部分查询的建议词 | q |
google_images | 图片搜索结果 | q、location |
google_maps | 地图商家、评价、照片 | q、type=search|place|review、ll |
google_maps_reviews | 某地点的所有评价 | data_id |
google_maps_photos | 某地点的所有照片 | data_id |
google_news | 带日期和来源的新闻搜索结果 | q、gl、hl |
google_shopping | 带价格的商品列表 | q、location |
google_product | 单个商品详情页 | product_id |
google_jobs | 职位列表 | q、location |
google_jobs_listing | 单个职位的完整详情 | q(base64 编码的职位 id) |
google_trends | 时间趋势数据 | q、geo、date |
google_scholar | 学术论文结果 | q |
google_scholar_author | 作者简介和论文 | author_id |
google_scholar_cite | 单篇论文的格式化引用 | q(引用 id) |
google_scholar_profiles | 按姓名查找作者 | mauthors |
google_events | 本地活动 | q、location |
google_play | Play 商店应用、图书、电影 | type、store、product_id |
google_finance | 股票和市场数据 | q |
google_reverse_image | 托管某图片的页面 | image_url |
google_local_services | 本地服务列表 | q、location |
| 参数 | 用途 |
|---|---|
q | 搜索查询词 |
location | 自由格式的位置字符串(例如 "New York, NY") |
gl | 国家代码(例如 us、de) |
hl | 界面语言(例如 en、es) |
device | desktop 或 mobile |
start | 用于分页的结果偏移量 |
num | 每页结果数 |
每个引擎的完整参数参考位于 REST API → Google SERP 部分。
示例:带位置的 Google 搜索
Section titled “示例:带位置的 Google 搜索”curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=best+pizza&location=Chicago%2C+Illinois&device=mobile"示例:Google 地图搜索
Section titled “示例:Google 地图搜索”curl "https://serp.shifter.io/v1?engine=google_maps&api_key=YOUR_API_KEY&q=pizza&type=search&ll=@41.8781,-87.6298,14z"示例:Google 职位
Section titled “示例:Google 职位”curl "https://serp.shifter.io/v1?engine=google_jobs&api_key=YOUR_API_KEY&q=software+engineer&location=Austin%2C+Texas"- 位置,超越自由格式
location字符串的精确地理定位。 - REST API → Google SERP,每个引擎的完整参数参考。