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

> Download crowd-sourced star/interest counts

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

Download crowd-sourced star counts from jmail.world users. Stars indicate community interest in specific emails, documents, and photos.

## Returns

`pd.DataFrame` with star count data.

## Example

```python theme={null}
from jmail import JmailClient

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

# Stars by entity type
print(stars.groupby("entity_type")["count"].sum().sort_values(ascending=False))

# Most starred emails
email_stars = stars[stars.entity_type == "email_message"]
top = email_stars.sort_values("count", ascending=False).head(20)
```

## Columns

| Column        | Type   | Description                                                                    |
| ------------- | ------ | ------------------------------------------------------------------------------ |
| `entity_type` | string | Entity type (`email_message`, `email_thread`, `photo`, `document`, `imessage`) |
| `entity_id`   | int    | Entity ID (FK to corresponding table)                                          |
| `count`       | int    | Number of stars                                                                |

## Direct URLs

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