bird email competitive watchlist brands send-time
Usage
bird email competitive watchlist brands send-time <watchlist-brand-id> [flags]Description
Takes a watchlist_brand_id from bird email competitive watchlist get and an
optional IANA timezone. Covers the last 90 days, with no range parameter.
Cells describe observed sending activity, not arrival, reading or subscriber
availability. The returned period and timezone label the grid; the panel
caches it for a day, so it can lag other reports. sample_days counts days
available for observation, not campaigns or independent recipients.
peak_send_window can be null when no sending was observed. This describes a
competitor's schedule, not a best time for your audience; timing hypotheses
need your own controlled test and engagement evidence.
API-key calls require Insights preview access for your organization.
Examples
bird email competitive watchlist brands send-time <watchlist-brand-id>Options
| Name | Description |
|---|---|
--response-schema | Print the fields this command returns, then exit |
--timezone | IANA timezone identifier to report send times in; defaults to UTC. The grid is folded into this zone before it is summed, so a send lands on the weekday and hour it happened at locally rather than the one it happened at in UTC. A zone this API does not know returns 422 rather than falling back to UTC, so an axis is never labelled with a zone the figures were not folded into. |
Related
| Name | Description |
|---|---|
bird email competitive watchlist brands create | Add a competitor brand to the watchlist |
bird email competitive watchlist brands delete | Remove a competitor brand from the watchlist |
bird email competitive watchlist brands get | Get a watched brand's figures |
Related resources
Continue with the documentation, guides and examples for this topic.