Email Warmup Service

Warmup you email accounts and restore your reputation for inbox placement. Real‑human seed email network for email warm‑up services. Fetch consented inboxes, register engagements, and get verified open/reply signals to improve sender reputation.

原始信息汇总

Email Warmup Service 数据集详情总结

基本信息

• API 名称：Email Warmup Service
• 所属类别：Email（电子邮件）
• API 创建者：StableVortex
• API 版本：v1 (current) / Version 1.0
• 服务级别：96% Service Level
• 延迟：167ms
• 订阅者数量：1 位订阅者
• 流行度：2 Popularity
• 定价：BASIC - $0.00（免费基础套餐）

核心功能概述

该 API 为电子邮件预热平台提供真实人类 Gmail 收件箱种子网络，帮助用户提升发件人声誉和邮件送达率。

主要特点

1. 真实且经同意的种子邮箱 — 所有种子收件箱均由真实个人拥有，并明确允许执行预热操作，无机器人账户或重复使用的地址
2. 两种互动模式：
   • 自动化：系统自动执行打开、移动、标记重要和回复操作，按完成互动计费
   • 手动：种子用户在个人 Gmail 中手动打开和回复邮件
3. 公平分配机制 — 种子按最近最少使用顺序返回，并设有每日使用限制
4. 活动去重功能 — 可选提供 campaign_uuid 防止同一天内同一活动中重复使用同一种子
5. 滥用保护 — 系统自动禁用将预热邮件删除或移至垃圾邮件的种子账户

API 接口说明

1. 获取种子邮箱（Fetch a Seed Email）

• 方法：GET /api/v1/seed
• 功能：获取一个适合特定互动类型的种子邮箱地址
• 必需参数：type（automated 或 manual）
• 可选参数：campaign_uuid（活动唯一标识符）

2. 注册互动（Register an Engagement）

• 方法：POST /api/v1/engagements
• 功能：注册已发送的预热邮件并预留资金
• 必需字段：seed_id、type、warmup_message_id（邮件头中的 Message-ID，必须唯一）
• 可选字段：campaign_uuid、required_actions（指定需要执行的打开、回复、移至收件箱等操作）、meta（额外元数据）
• 注意：如需回复操作，必须在 meta 中包含 reply_text 或 reply_html

3. 查看互动状态（Check Engagement Status）

• 方法：GET /api/v1/engagements/{engagement}
• 功能：获取已注册互动的当前状态及各操作时间戳
• 状态类型：pending（待处理）、processing（处理中）、completed（已完成）、failed（失败）
• 计费说明：partner_price 字段显示每次互动费用；失败状态不产生费用

限流与错误码

速率限制

• 每分钟每个合作伙伴 60 个请求
• 超出限制返回 429 Too Many Requests，附 Retry-After 响应头

常见 HTTP 状态码

状态码	含义
200	成功（GET 端点）
201	互动成功注册
400	无效请求（参数缺失或格式错误）
402	余额不足
403	禁止访问（合作伙伴被暂停或互动不属于您）
404	种子或互动未找到
409	重复的预热邮件（相同种子 + Message-ID）
422	验证错误（如种子不支持所请求的互动类型）
429	超出速率限制
500	服务器内部错误（请稍后重试）

典型使用流程

1. 获取种子 → 调用 GET /api/v1/seed 并指定互动类型（automated/manual）及可选的 campaign_uuid
2. 发送预热邮件 → 使用返回的种子邮箱地址作为收件人，通过您自己的 SMTP 发送邮件，并置入唯一 Message-ID 头
3. 注册互动 → 调用 POST /api/v1/engagements 提交种子 ID、Message-ID 及所需操作
4. 等待处理 → 自动化互动通常在 5 分钟内处理完成；手动互动需等待真实用户操作，耗时较长
5. 检查状态 → 调用 GET /api/v1/engagements/{id} 直到状态变为 completed 或 failed
6. 重复操作 → 为后续邮件获取新的种子