用途:通过统一接口获取搜索引擎结果,把网页、图片、新闻、购物、地图与视频等搜索结果转成结构化 JSON,便于程序化使用。
主要能力:基础 URL 为 https://serpapi.com/search。支持的引擎包括 engine=google(网页)、google_images、google_news、google_shopping、google_maps(本地商户)、youtube,另列有 engine=bing、engine=duckduckgo。
使用方式:需先设置环境变量 SERPAPI_TOKEN。典型调用为 curl -s "https://serpapi.com/search?engine=google&q=artificial+intelligence&api_key=$SERPAPI_TOKEN",可接 jq 提取 organic_results 中的 title、link、snippet。图片、新闻、购物、视频、地图分别对应 images_results、news_results、shopping_results、video_results、local_results 字段。
常用参数:q(必填)、engine、location、gl(国家码)、hl(语言码)、start(分页偏移)、num(上限 100)、safe、device。地图可用 ll 或 location 加 z 指定坐标与缩放。分页示例:start=0 与 start=10。账户用量可通过 https://serpapi.com/account?api_key=$SERPAPI_TOKEN 查询 plan_name、searches_per_month、this_month_usage。
排障:请求失败时可运行 zero doctor check-connector --env-name SERPAPI_TOKEN,或 zero doctor check-connector --url https://serpapi.com/search --method GET。
使用建议与限制:建议使用具体引擎而非 tbm 参数;本地搜索加 location 与 gl;结果默认缓存,可用 no_cache=true 获取最新数据;用 jq 过滤大响应。费用、套餐价格与调用配额资料未完整提供,请以账户接口或官方页面为准。