bird email inbox-insights spam-traps
Usage
Code example
bird email inbox-insights spam-traps <sending-domain> [flags]Description
Read spam-trap totals, kinds, networks and sampled hits for a verified owned domain. Dates are inclusive UTC days, at most 30 days apart; compare=previous_period includes the preceding period. hit_rows has its own status and truncated_types; empty rows do not negate a positive total, and row counts cannot reconstruct total hits. A measured zero is valid. Hits alone do not identify the sending campaign or establish why placement changed.
API-key calls require Insights preview access for your organization.
Examples
Code example
bird email inbox-insights spam-traps <sending-domain>Options
| Name | Description |
|---|---|
--compare | Include the prior equal-length period, populating compared_to and delta. Possible values: previous_period. |
--from | First UTC day of the period, inclusive, in YYYY-MM-DD: the same window convention as the email statistics endpoints. Defaults to 30 days before to. It may be at most 30 days before to, which is also the default, so a request naming neither date is already at the limit. Asking for more answers 422: the page pairs these figures with Bird's own per-provider sending statistics, and those are kept for 30 days, so a longer period could only describe two different spans side by side. |
--response-schema | Print the fields this command returns, then exit |
--to | Last UTC day of the period, inclusive, in YYYY-MM-DD. Defaults to today. |
Related
| Name | Description |
|---|---|
bird email inbox-insights authentication | Get email authentication standing for a sending domain |
bird email inbox-insights blocklists | Check whether a sending domain's infrastructure is blocklisted |
bird email inbox-insights complaints | Get the Google-reported spam rate for a sending domain |
bird email inbox-insights placement | Get inbox placement for a sending domain |
Related resources
Continue with the documentation, guides and examples for this topic.