> ## Documentation Index
> Fetch the complete documentation index at: https://jmail.world/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# star_counts()

> 下载众包的星标/兴趣统计数据

```python theme={null}
client.star_counts() -> pd.DataFrame
```

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

## 返回值

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

## 示例

```python theme={null}
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
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.