star_counts() - Jmail Data API

client.star_counts() -> pd.DataFrame

下载来自 jmail.world 用户的众包星标计数数据。星标表示社区对特定邮件、文档和照片的关注度。

返回值

包含星标计数数据的 pd.DataFrame。

示例

from jmail import JmailClient

client = JmailClient()
stars = client.star_counts()

# 按实体类型分组的星标数
print(stars.groupby("entity_type")["count"].sum().sort_values(ascending=False))

# 星标数最多的邮件
email_stars = stars[stars.entity_type == "email_message"]
top = email_stars.sort_values("count", ascending=False).head(20)

列

列名	类型	描述
`entity_type`	string	实体类型（`email_message`、`email_thread`、`photo`、`document`、`imessage`）
`entity_id`	int	实体 ID（关联到对应表的外键）
`count`	int	星标数量

直接访问 URL

https://data.jmail.world/v1/star_counts.parquet
https://data.jmail.world/v1/star_counts.ndjson.gz