> ## 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)
```

## 列

| Column | Type | Description |
| - | - | - |
| `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.