计费与积分
积分如何使用、每种调用的价格、充值档位，以及四条计费规则。
SerpHubAPI 采用预付积分制。一套积分通用于所有接口和引擎：用美元充值，按调用扣积分。
四条计费规则
- 失败不计费。 调用返回错误——包括所有尝试均未成功的情况——一律不收费。
- 空结果不计费。 搜索成功但没有结果，扣 0 积分。
- 缓存命中不计费。 使用
mode=cache_first时，由缓存返回的结果扣 0 积分。 - 充值余额永不过期。 你购买的积分会一直留在钱包里，直到用完为止。
每个响应都会在 meta.credits_charged（Markdown 响应为 X-Credits-Charged 响应头）中写明本次实际扣费。
各项价格
| 动作 | 积分 |
|---|---|
实时搜索（mode=live） | 该服务的单价——如 google/web 10、deepseek/web 8（全部价格） |
缓存优先搜索（mode=cache_first） | 5 |
| 缓存优先搜索，命中缓存 | 0 |
正文抓取（/v1/fetch） | 每页 3 |
搜索时 include_content | 每页 3（最多 5 页） |
| 空结果 | 0 |
| 调用失败 | 0 |
GET /v1/searches/{id}、/v1/account、/v1/engines | 0 |
返回条数（num）不影响价格。
示例： google/web 实时搜索加 include_content: 3，三页都抓取成功，扣 10 + 9 = 19 积分；其中一页失败则扣 16 积分。
预扣
调用开始前，会先从余额中预留本次的最高可能费用，调用结束后未用掉的部分立即释放。余额不足以覆盖最高费用时，返回 402 insufficient_balance。例如 google/web 实时搜索加 include_content: 5，需要至少 25 积分可用。
赠送积分
- 每个新账户赠送 1,000 积分（约 100 次实时搜索），无需绑卡。
- 赠送积分自注册起 30 天内有效，到期未用完的部分作废。
- 总是先扣赠送积分，再扣充值积分。
GET /v1/account 会分别返回 gift_credits、gift_expires_at 和 paid_credits。
充值档位
| 档位 | 价格 | 到账积分 | 约合每千次实时搜索 |
|---|---|---|---|
| 免费 | $0 | 1,000（赠送，30 天） | — |
| Starter | $15 | 15,000 | $10.00 |
| Growth | $49 | 60,000 | 约 $8.17 |
| Business | $149 | 220,000 | 约 $6.77 |
| Scale | $499 起 | 商务定制 | 联系销售 |
- 自定义金额： 可充值 $15 起的任意整数美元金额，按所达到的最高档位的单价折算到账（例如 $100 按 Growth 档单价、$200 按 Business 档单价），不会比下一档更差。
- Scale 档请发邮件至 support@serphubapi.com。
- 充值以美元信用卡一次性支付，没有订阅，不会自动续费。
在 /dashboard/wallet 充值并查看充值记录。
低余额提醒
余额低于 200 积分时（可在 /dashboard/settings 修改阈值或关闭提醒），我们会发送一次邮件提醒。余额为 0 时，接口返回明确的错误码 402 insufficient_balance，绝不静默失败。充值后提醒会重新生效。
流水与用量
- 每一笔扣费、退回和充值都会生成一条流水，可在 /dashboard/wallet 查看并导出 CSV。
- 按天、接口、引擎、Key 的用量统计见 /dashboard/usage。
- 每次调用及其费用见 /dashboard/logs。
- 为避免某个集成耗尽共用余额，可在 /dashboard/keys 为其 Key 设置每日积分上限。
退款
计费问题与退款申请请发邮件至 support@serphubapi.com，并附上账户邮箱和收据编号。另见账单与发票。