Gmail Postmaster Tools API logo

Gmail Postmaster Tools API

Gmail Postmaster Tools API

Gmail Postmaster Tools API 查询发件域名的 Gmail 投递质量:spam rate、authentication(SPF/DKIM/DMARC)通过率、声誉评分。

访问站点 ↗健康巡检 9 小时前
适合什么时候用

直接来自 Gmail 的真实投递数据

先注意什么

只有 Gmail 的数据(不覆盖 Outlook、Yahoo 等)

第一步先查

postmaster.google.com 验证域名所有权后启用 API。GET /v1/domains/{domain}/trafficStats 查投递统计。

认证
CORS
不支持
HTTPS
注册
?
延迟
41 ms
协议
REST
计费

可用率 · 30 天窗口

巡检: 1可用率: 100%平均延迟: 41ms
01

关于这个 API

Postmaster Tools 是 Google 给「发件方」准备的工具——任何大规模发邮件给 Gmail 用户的公司(SaaS 的交易通知、newsletter 平台、营销邮件商)都应该用这个。API 提供四类核心数据:spam rate(多少邮件被分类为 spam)、IP reputation(你的发件 IP 在 Gmail 眼里信誉如何)、domain reputation(域名信誉)、SPF/DKIM/DMARC 通过率(多少邮件通过了认证)。这些数据是诊断邮件投递问题的根本依据——如果发现 spam rate 突然升高,得快速查邮件内容、抵达模式、用户互动等多个因素,否则你的域名会被 Gmail 降级到 spam 文件夹。比 SendGrid 等 ESP 的"模糊指标"更权威,因为来自 Gmail 本身。

02

你可以做什么

  • 1大规模邮件发送方监控 Gmail 投递质量
  • 2排查邮件被分类为 spam 的原因
  • 3配合 SendGrid/Mailgun 等做 deliverability 优化
  • 4触发告警当 spam rate 异常
03

优劣对比

优点

  • 直接来自 Gmail 的真实投递数据
  • 区分 user-marked-spam vs filter-classified-spam
  • 免费

注意事项

  • 只有 Gmail 的数据(不覆盖 Outlook、Yahoo 等)
  • 数据更新有 1-2 天延迟
  • 小量发件人数据稀疏看不出趋势
04

示例请求

通用模板 — 实际 endpoint 请查阅文档替换 <endpoint>。
curl https://google.com/<endpoint>
05

快速开始

postmaster.google.com 验证域名所有权后启用 API。GET /v1/domains/{domain}/trafficStats 查投递统计。

06

常见问题

怎么知道我的域名 reputation 受影响了?+

API 返回的 spamRate 长期 > 0.1% 就是 high;reputationCategory 为 LOW 或 BAD 就需要立即调查。

能拿到具体哪些邮件被分类为 spam 吗?+

不能。Postmaster Tools 只给聚合统计,单封邮件诊断需要查 ESP 的日志或在用户测试账户里抓。

07

技术细节

CORS: NoHTTPS: Yes注册: ?开源: No
认证方式
unknown
计费
unknown
协议
REST
SDK
python, javascript, go, java
响应时间
41 ms
上次巡检
2026/5/12 07:37:31
08

标签

09

更多来自 Google 的 API