全平台搜索与公开数据 API 为开发者与 AI Agent 提供开箱即用的结构化 JSON
一个 API Key,一次请求,就能拿到搜索引擎、社交媒体、电商、地图和网页的结构化 JSON。每个接口都标明了参数和积分价格。
- API 接口
- 47
- 数据类别
- 6
- 积分 / 次请求
- 1–3
import requests
res = requests.post(
"https://api.serpbase.dev/google/search",
headers={"X-API-Key": "YOUR_API_KEY"},
json={"q": "best ai search agents", "gl": "us", "hl": "en"}
)
data = res.json()
print("Found", len(data["organic"]), "organic results")注册前,先免费跑一次真实的 Google 搜索
输入关键词,直接查看你的代码会收到的 JSON,并一键复制 cURL、Python、JavaScript、Go、Java、PHP 调用代码。
- 试用响应包含最多 5 条自然结果,以及知识图谱、AI 概览、相关问题等我们能解析的板块(均为精简版)
- 使用自己的 API Key 时每次搜索 1 积分
- 浏览器不会发送任何 API key。
POST /google/search接口文档这是此前抓取的一条真实 Google 结果,按 API 完整返回格式展示。运行一次即可换成实时的试用结果。
{
"credits_charged": 1,
"elapsed_ms": 1891,
"knowledge_graph": {
"attributes": {
"CEO": "Elon Musk (Oct 2008–)",
"Founded": "July 1, 2003, San Carlos, CA",
"Founders": "Elon Musk, Martin Eberhard, JB Straubel, Marc Tarpenning, Ian Wright",
"Headquarters": "Austin, TX",
"Number of employees": "134,785 (2025)",
"Subsidiaries": "Tesla Robotaxi, Tesla Energy, Tesla Automation"
},
"description": "Tesla, Inc. is an American multinational automotive and clean energy company. Headquartered in Austin, Texas, it designs, manufactures, and sells battery electric vehicles, stationary battery energy storage devices from home to grid-scale, solar panels and solar shingles, and related products and services.",
"description_link": "https://en.wikipedia.org/wiki/Tesla,_Inc.",
"description_source": "Wikipedia",
"title": "Tesla Inc",
"type": "NASDAQ: TSLA"
},
"organic": [
{
"display_link": "www.cnbc.com",
"display_url": "www.cnbc.com",
"link": "https://www.cnbc.com/2026/10/18/meta-tesla-netflix-earnings-preview.html",
"position": 1,
"rank": 1,
"sitelinks": [
{
"display_url": "www.google.com",
"link": "https://www.google.com/goto?url=CAESgwEB6zswFYObUN2TrvpFoTt3NQYhJ_VX6QyKN9trB86nOGp3vc1whceM-AjJ-fDhpNfm3sOunHfkflUNarnoafcUiQuQrLoWouxl3o3IQ9XZP70iDsKJ-NcNwsl7o1Ue18TiWp7ojlDDOvSU7U44vIioP4aggIumTEpogDxyCplRU55TBg/disclaimer",
"source_url": "https://www.google.com/intl/en_us/googlefinance/disclaimer/?sa=X&ved=2ahUKEwiDzMbXicmXAxXCElkFHW_XJjcQ1AF6BAg8EAI",
"title": "Disclaimer",
"url": "https://www.google.com/goto?url=CAESgwEB6zswFYObUN2TrvpFoTt3NQYhJ_VX6QyKN9trB86nOGp3vc1whceM-AjJ-fDhpNfm3sOunHfkflUNarnoafcUiQuQrLoWouxl3o3IQ9XZP70iDsKJ-NcNwsl7o1Ue18TiWp7ojlDDOvSU7U44vIioP4aggIumTEpogDxyCplRU55TBg/disclaimer"
},
{
"display_url": "www.google.com",
"link": "https://www.google.com/goto?url=CAESgwEB6zswFYObUN2TrvpFoTt3NQYhJ_VX6QyKN9trB86nOGp3vc1whceM-AjJ-fDhpNfm3sOunHfkflUNarnoafcUiQuQrLoWouxl3o3IQ9XZP70iDsKJ-NcNwsl7o1Ue18TiWp7ojlDDOvSU7U44vIioP4aggIumTEpogDxyCplRU55TBg/add-investments",
"source_url": "https://www.google.com/finance/portfolio/watchlist?sa=X&ved=2ahUKEwiDzMbXicmXAxXCElkFHW_XJjcQnIcKegQIOxAJ",
"title": "Add investments",
"url": "https://www.google.com/goto?url=CAESgwEB6zswFYObUN2TrvpFoTt3NQYhJ_VX6QyKN9trB86nOGp3vc1whceM-AjJ-fDhpNfm3sOunHfkflUNarnoafcUiQuQrLoWouxl3o3IQ9XZP70iDsKJ-NcNwsl7o1Ue18TiWp7ojlDDOvSU7U44vIioP4aggIumTEpogDxyCplRU55TBg/add-investments"
},
{
"display_url": "www.google.com",
"link": "https://www.google.com/goto?url=CAESgwEB6zswFYObUN2TrvpFoTt3NQYhJ_VX6QyKN9trB86nOGp3vc1whceM-AjJ-fDhpNfm3sOunHfkflUNarnoafcUiQuQrLoWouxl3o3IQ9XZP70iDsKJ-NcNwsl7o1Ue18TiWp7ojlDDOvSU7U44vIioP4aggIumTEpogDxyCplRU55TBg/analyze-tesla-inc",
"source_url": "https://www.google.com/finance/quote/TSLA:NASDAQ?sa=X&ved=2ahUKEwiDzMbXicmXAxXCElkFHW_XJjcQ3ecFKAV6BAg3EAY",
"title": "Analyze Tesla Inc",
"url": "https://www.google.com/goto?url=CAESgwEB6zswFYObUN2TrvpFoTt3NQYhJ_VX6QyKN9trB86nOGp3vc1whceM-AjJ-fDhpNfm3sOunHfkflUNarnoafcUiQuQrLoWouxl3o3IQ9XZP70iDsKJ-NcNwsl7o1Ue18TiWp7ojlDDOvSU7U44vIioP4aggIumTEpogDxyCplRU55TBg/analyze-tesla-inc"
}
],
"source_url": "https://www.google.com/goto?url=CAESgwEB6zswFYObUN2TrvpFoTt3NQYhJ_VX6QyKN9trB86nOGp3vc1whceM-AjJ-fDhpNfm3sOunHfkflUNarnoafcUiQuQrLoWouxl3o3IQ9XZP70iDsKJ-NcNwsl7o1Ue18TiWp7ojlDDOvSU7U44vIioP4aggIumTEpogDxyCplRU55TBg",
"title": "Meta Platforms and Tesla are among the companies set to report next week. What to expect",
"url": "https://www.cnbc.com/2026/10/18/meta-tesla-netflix-earnings-preview.html"
},
{
"date": "1 day ago",
"display_link": "https://finance.yahoo.com › quote › TSLA",
"display_url": "https://finance.yahoo.com › quote › TSLA",
"link": "https://finance.yahoo.com/quote/TSLA/",
"position": 2,
"published_at": "1 day ago",
"rank": 2,
"snippet": "Tesla, Inc. (TSLA) 28,957.36% Baseline. Close 354.72 Open 357.48 Bid 368.80. Range 354.47 - 369.58 52 Week Range 297.38 - 498.83 Volume 38,651, ...",
"source_url": "https://www.google.com/goto?url=CAESYAHrOzAV0Q2uc-d8mt2At-khHuHwKGSqkS85kXL44B4zKALhwjD9ayR0ZKi73coj1vwyaB_xHPc6mZIBSmsgCMCwZPdOM6X-lRMbFvgVXSWrIOBV2Z_a9cMdu_s6q2pXMg",
"title": "Tesla, Inc. (TSLA) Stock Price, News, Quote & History",
"url": "https://finance.yahoo.com/quote/TSLA/"
},
{
"display_link": "https://robinhood.com › Stocks",
"display_url": "https://robinhood.com › Stocks",
"link": "https://robinhood.com/us/en/stocks/TSLA/",
"position": 3,
"rank": 3,
"snippet": "Tesla(TSLA) stock is priced at $352.46, giving the company a market capitalization of 1.45T. It carries a P/E multiple of 329.57.Read more",
"source_url": "https://www.google.com/goto?url=CAESYwHrOzAVFdXXVy2WHCo2zyJ0zvAjoVAxjvBKIvXLNvbD6OCsjsP-8htxx9D8A1D-I8VqVoeHGSzvi6TbF7PKLC9S6QDjMf1pv9xpAYotE5ghRO2WpJx8iHq7gOL83EqskLIoHA",
"title": "Tesla: TSLA Stock Price Quote & News",
"url": "https://robinhood.com/us/en/stocks/TSLA/"
},
{
"display_link": "https://digital.fidelity.com › dashboard › summary",
"display_url": "https://digital.fidelity.com › dashboard › summary",
"link": "https://digital.fidelity.com/prgw/digital/research/quote/dashboard/summary?symbol=TSLA",
"position": 4,
"rank": 4,
"snippet": "Tesla (TSLA) is trading at 368.06 Open Price 357.5 Previous close 368.06. Index NASDAQ100,R1000,R3000,SP500",
"source_url": "https://www.google.com/goto?url=CAESkQEB6zswFb-ymy1HS3Xh0knUQK1be6f5_Eowhon8_aQ7_ySuUyWRlAab4azfRGqczuuNPmibG-tzLzN7L4F0s85H4ksfzjUYY2TEj8j1VdjjBK65X_vQGhIomtlEw8jss1FxxGJVCTfhJeBpydQ7Ezuwuk3n4nZsb2NLxY9LPIusRstMVrUxtKdpSf4kn-nx6y1c",
"title": "TSLA - TESLA INC | Stock Quotes from Fidelity Investments",
"url": "https://digital.fidelity.com/prgw/digital/research/quote/dashboard/summary?symbol=TSLA"
},
{
"display_link": "https://www.cnbc.com › quotes › TSLA",
"display_url": "https://www.cnbc.com › quotes › TSLA",
"link": "https://www.cnbc.com/quotes/TSLA",
"position": 5,
"rank": 5,
"snippet": "Tesla Inc TSLA:NASDAQ · Open370.28 · Day High370.49 · Day Low363.64 · Prev Close368.06 · 52 Week High498.83 · 52 Week High Date12/22/25 · 52 Week Low297.38 · 52 ...Read more",
"source_url": "https://www.google.com/goto?url=CAESWwHrOzAVo4AO4qr2Iq60j4OH2YbKg-TOOGMssl83NF71AsNIA53itxwKGja5AilksVbY9HbfLvjY3Rbi2UurKYIyJyf8ozBgzIa--MlEAPg5lJ6ezfla5Sl7ZDw",
"title": "TSLA: Tesla Inc - Stock Price, Quote and News",
"url": "https://www.cnbc.com/quotes/TSLA"
},
{
"display_link": "https://www.tradingview.com › ... › Motor Vehicles",
"display_url": "https://www.tradingview.com › ... › Motor Vehicles",
"link": "https://www.tradingview.com/symbols/NASDAQ-TSLA/",
"position": 6,
"rank": 6,
"snippet": "The current price of TSLA is 368.06 USD — it has increased by 3.76% in the past 24 hours. TSLA stock has fallen by −3.80% TSLA price has a max estimate of 550. ...",
"source_url": "https://www.google.com/goto?url=CAESawHrOzAVchvcp21W18wx27C_wPhTYaxXLLwonMPNzDSAnKYzWqkq4O-WRNM1q5B6bAF7B0Z-Jlq3yrw2W4qE_thS4lSkzuxNgAjBWK9nZ4JFhKfpmd6mAMpCRk7f2fbix3jIwRp81UYUv72b",
"title": "TSLA Stock Price - Tesla, Inc.",
"url": "https://www.tradingview.com/symbols/NASDAQ-TSLA/"
},
{
"display_link": "https://www.google.com › quote › TSLA:NASDAQ",
"display_url": "https://www.google.com › quote › TSLA:NASDAQ",
"link": "https://www.google.com/finance/quote/TSLA:NASDAQ",
"position": 7,
"rank": 7,
"snippet": "Tesla Inc (TSLA) Stock. Avg. vol. 35.25M Volume 538.84K … low $297.38 EPS $1.08 Beta 1.92 Shares outstanding 3.95B No. of employees 135K Mkt. cap 1.45T",
"source_url": "https://www.google.com/finance/quote/TSLA:NASDAQ",
"title": "Tesla Inc (TSLA) Stock Price & News - Google Finance",
"url": "https://www.google.com/finance/quote/TSLA:NASDAQ"
},
{
"display_link": "https://seekingalpha.com › symbol › TSLA",
"display_url": "https://seekingalpha.com › symbol › TSLA",
"link": "https://seekingalpha.com/symbol/TSLA",
"position": 8,
"rank": 8,
"snippet": "Tesla, Inc. is currently listed on NASDAQ under TSLA. One share of TSLA stock can currently be purchased for approximately $354.72.",
"source_url": "https://www.google.com/goto?url=CAESXwHrOzAV1wVdOIkoPpUFdDyBhccUJG8KNL_oE0sHSKVPU-quqsjKd_lhrtRhteu3lsfw2-5APEA_rckH5iLsgatc2oyJfZH7X7dmo_ZWTGgF478c4QQ5jYlaetIg42St",
"title": "Tesla, Inc. (TSLA) Stock Price, Quote, News & Analysis",
"url": "https://seekingalpha.com/symbol/TSLA"
}
],
"page": 1,
"people_also_ask": [
{
"question": "Is Tesla a buy or sell today?"
},
{
"question": "How much will Tesla stock be worth in 5 years?"
},
{
"question": "How much is $10,000 invested in Tesla 10 years ago?"
},
{
"question": "Can Tesla stock reach $3000?"
}
],
"product_id": "google_web_search",
"query": "tesla stock",
"related_searches": [
"NASDAQ: NVDA",
"SHE: 002594",
"NASDAQ: AAPL",
"NYSE: TM",
"Elon Musk",
"Austin, Texas",
"San Carlos, California",
"Martin Eberhard"
],
"request_id": "r-sample-google-web-search",
"search_type": "search",
"status": 0
}调用代码
curl -X POST 'https://api.serpbase.dev/google/search' \
-H "Content-Type: application/json" \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{"q":"iPhone","hl":"en","gl":"us"}'为现代应用与 AI Agent 打造的一站式多平台数据基础设施
涵盖搜索引擎、社媒情报、全球电商商品、房产交易数据与通用网页采集,一套标准 API 搞定全网数据。
通用搜索
多引擎搜索 (Google & DuckDuckGo)
使用各搜索接口支持的参数获取搜索结果。
社交媒体
社交媒体情报 (TikTok & X/推特)
查询单个 TikTok 资料、TikTok 帖子与 X 帖子,不是通用社交搜索或历史档案。
电商零售
电商联想、商品与 App Store 应用
Amazon/Walmart 自动补全、支持的零售商品查询、Myntra 搜索及 App Store 应用查询;Apple 指应用而非硬件。
网页采集
通用网页深度采集与爬虫
提取网页、执行有界抓取或生成 UA;包括 UA 生成在内均按目录固定请求价格收费。
高度一致的 JSON 规范
跨搜索、社媒、电商和爬虫所有接口统一遵循统一的规范结构,极度适配 LLM Tool Calling。
按目录请求价格计费
1–3 积分 / 请求
按产品支持的地区与语言参数
各接口支持的国家和语言输入见对应文档,地区参数不保证任意地区的代理出口。
选择适合你的积分套餐
购买前核对当前价格、积分、限购规则和有效期。
限时额度
此类积分有有效期,续费和到期规则以套餐与结算页为准。
预付积分包 · 额度永不过期
单次购买,额度不按日期过期,用多少扣多少。套餐越大,每千次单价越低,并发 QPS 也越高。
目录请求价格
展开全部 47 个接口的价格
计费规则说明
每请求按目录固定价格计费,不按返回页数计费。Web Crawl 和 User Agent 当前均为每请求 1 积分;User Agent 并非免费。有来源和资源身份依据的真实不存在结果正常收费。仅有 no_results、HTTP 404 或缺少 hydration/解析数据不能证明不存在。目前已执行的失败可能扣费,并非所有失败都保证退款。credits_charged 表示实际扣费:0 表示报告为零,null 或缺失表示未知。charge_status 为 UNKNOWN 时即使有扣费数值也仍是未知。请核对账户记录并提供 request_id 联系支持,不要假定已退款或盲目重试。
账号 QPS 自动升档
符合条件的充值确认入账后,按累计 USD 金额自动提升至至少以下 QPS:$3 → 2、$50 → 5、$100 → 10、$200 → 15、$1,000 → 50、$10,000 → 500。未满 $3 保持当前账户限额。只升不降,已有更高限额不会降低;不是无限 QPS。
| 累计符合条件的充值(USD) | 至少提升至(QPS,请求/秒) |
|---|---|
| ≥ $3 | 2 QPS |
| ≥ $50 | 5 QPS |
| ≥ $100 | 10 QPS |
| ≥ $200 | 15 QPS |
| ≥ $1,000 | 50 QPS |
| ≥ $10,000 | 500 QPS |
仅统计已确认入账的 USD 积分包(credit_pack)和自动充值(auto_topup)付款。订阅(包括 Starter Boost)、赠送和礼品码不计入。积分余额不等于累计充值美元金额;非 USD 付款不能未经换汇直接计作 USD。
同一账户的所有 API Key、产品和网关共用一个 QPS 限额;增加 Key 不会增加限额。
符合条件的充值确认入账后自动提升账号 QPS,付款跳转回来不代表已生效。现有限额以账户显示的服务端数值为准,API Key 同步可能短暂延迟。
购买前请在计费页面查看当前价格、积分数量和有效期。可购买套餐及账户限额以实际配置为准;赠送积分请以账户记录为准。
开始前的常见问题
客户真正会问的几件事:积分、限速、报错、翻页、付款。
怎么开始?有免费额度吗?
新账户自带 100 积分免费额度,不用绑卡。在概览页一键创建 API Key,就能在试用台或自己的代码里发出第一个请求。文档里有 curl、Python、JavaScript、Go、Java、PHP 的现成示例,复制即可用。
积分怎么扣?失败的请求收费吗?
每个请求按该接口的标价扣固定积分(大多数是 1 积分),与返回多少条结果无关。以下情况一律不扣费:参数错误、Key 无效、超出速率上限、余额不足,以及请求没能发到数据源。请求已发到数据源并返回了可用结果就会扣费,哪怕结果是"没有匹配项"。
每个响应里的 credits_charged 字段就是这次实际扣除的积分数,以它为准。
我的速率上限是多少?怎么提高?
账号 QPS 自动升档
符合条件的充值确认入账后,按累计 USD 金额自动提升至至少以下 QPS:$3 → 2、$50 → 5、$100 → 10、$200 → 15、$1,000 → 50、$10,000 → 500。未满 $3 保持当前账户限额。只升不降,已有更高限额不会降低;不是无限 QPS。
| 累计符合条件的充值(USD) | 至少提升至(QPS,请求/秒) |
|---|---|
| ≥ $3 | 2 QPS |
| ≥ $50 | 5 QPS |
| ≥ $100 | 10 QPS |
| ≥ $200 | 15 QPS |
| ≥ $1,000 | 50 QPS |
| ≥ $10,000 | 500 QPS |
仅统计已确认入账的 USD 积分包(credit_pack)和自动充值(auto_topup)付款。订阅(包括 Starter Boost)、赠送和礼品码不计入。积分余额不等于累计充值美元金额;非 USD 付款不能未经换汇直接计作 USD。
同一账户的所有 API Key、产品和网关共用一个 QPS 限额;增加 Key 不会增加限额。
符合条件的充值确认入账后自动提升账号 QPS,付款跳转回来不代表已生效。现有限额以账户显示的服务端数值为准,API Key 同步可能短暂延迟。
请求超时或报错了,积分会退吗?
系统能确认"没有执行"的失败会自动退回,不用申请。超时的情况不同:请求可能已经执行完,只是结果在回传时丢了,这类不会自动退款。如果你被扣费却没拿到结果,带上响应里的 request_id 提交工单,我们会核查并处理。
status 1029、1503、1502 是什么意思?服务是不是挂了?
不是。所有接口都返回 HTTP 200,有没有成功看响应里的 status 字段:0 是成功;1029 是你超出了自己的每秒上限,按 Retry-After 响应头里的秒数等一下再发;1503 是那一刻没有空闲的抓取通道,不扣费,稍后重试即可;1502 和 1504 是数据源出错或超时。
响应头 X-SerpBase-Retryable 为 true 表示原样重发有可能成功,为 false 表示请求本身要改。只有持续几分钟的大量失败才算异常,把 request_id 发给我们,我们会查。
结果是手机版还是电脑版?能拿到原始网页吗?
Google 搜索目前返回手机版排版的结果,电脑版选项还没开放。接口只返回解析好的 JSON,不提供 Google 原始网页。有特殊需求可以联系我们定制。
翻页怎么算?哪些接口支持翻页?
支持 page 参数的接口:Google 网页、图片、新闻、视频、购物、招聘、学术、图书、财经搜索;Google 地图搜索(每页 20 个地点);Amazon、eBay、Walmart 搜索。每翻一页是一次请求,按该接口标价扣费。没有一次返回 100 条的参数。
详情类接口、自动补全,以及 YouTube、Reddit 搜索一次请求返回一页,没有翻页参数。
积分会过期吗?
购买积分包得到的积分不过期,一直在账户里。订阅和活动赠送的额度有有效期,到期前会邮件提醒。账户页分别显示两部分各有多少。
怎么付款?能开发票吗?
支持银行卡(两家支付渠道)和加密货币。付款后积分自动到账,通常几分钟内;没到账请带上订单号提交工单。
发票由付款渠道开具(它们作为代收方完成交易)。通过 Dodo 付款的订单,在「账单 → 订单」里点已付款订单的「获取发票」即可下载;通过 Creem 付款的,收据会发到付款时填写的邮箱。加密货币付款如需付款凭证,请提交工单。