Yahoo Email Deliverability Performance Feeds
Yahoo's server-side data feeds for senders: the Placement Feed (inbox/spam/folder/error/complaints) and Campaign Performance Feed (engagement metrics), with schemas and SLAs.
Yahoo offers data feeds that report email placement and engagement derived straight from the Yahoo mail servers, rather than from tracking pixels or seed/panel data. Yahoo positions this as more privacy-conscious than pixel tracking and more representative than panel sources with limited sample sizes, given Yahoo's hundreds of millions of active users.
For a sender, this is ground-truth placement data at a major mailbox provider — the only direct way to see inbox-vs-spam folder placement at Yahoo without seed lists.
The two feeds
Placement Feed
Tracks where messages land (inbox, spam, folders) plus errors and complaints. Data is filtered using an allowlist of sender domains or sender IP addresses supplied by the consumer.
| Dimensions | Metrics |
|---|---|
dkim_domain, sender_domain, ip_address, xheader, xheader_value |
inbox_delivers, spam_delivers, folder_delivers, error_delivers, complaints |
The xheader/xheader_value dimensions let a sender break results down by a custom X-header (e.g. a campaign ID stamped on outgoing mail).
Campaign Performance Feed
Measures post-delivery engagement, broken down by sender domain and campaign. Filtered by a sender allowlist of sender domains.
| Dimensions | Metrics |
|---|---|
declared_template_namespace, declared_template_id, declared_template_goal, delivery_type, client, sender_domain, sender_email, engagement_date, user_local_hour, is_scrubbed |
delivered, opened, link_clicked, deleted, marked_read, forwarded, starred, archived, moved, push_notif_opened, replied, marked_spam, dwell_time_read, dwell_time_glance, dwell_time_skim |
Note the depth of the engagement signals — including deletes, reply, spam votes, push-notification opens, and dwell-time buckets (read/glance/skim). These are the same kinds of signals mailbox providers use internally for reputation (see Foundations of Email Deliverability).
Feed specifications
| Spec | Placement Feed | Campaign Performance Feed |
|---|---|---|
| Reporting granularity | Hourly | Hourly |
| Delivery granularity | Hourly | Daily |
| SLA (data latency) | 12 hours | 48 hours |
| Retention | 30 days | 30 days |
| File format | Avro | Avro |
| Timezone | UTC | UTC |
| Filtering | Allowlist of sender domains or sender IPs | Allowlist of sender domains |
Access
No public pricing, formal eligibility criteria, or self-serve enrollment is published. Contact mail-questions@yahooinc.com to learn about the program and access requirements.
How it fits a deliverability workflow
- Placement monitoring: replace or validate seed-list testing at Yahoo with actual per-domain/per-IP inbox vs. spam counts; watch
error_deliversalongside SMTP logs (see Yahoo SMTP Error Codes). - Complaint-rate tracking:
complaintsoverinbox_deliversapproximates the rate Yahoo enforces against the 0.3% threshold (Yahoo Sender Requirements); pair with per-recipient suppression from the Complaint Feedback Loop. - Engagement optimization: dwell-time and action metrics (deletes vs. reads,
user_local_hour) inform content, segmentation, and send-time decisions per campaign/template. - Stream comparison: dimensions by
dkim_domain/ip_addressshow how separated mail streams perform relative to each other (see Advanced IP Segmentation).