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

> Crowd-basierte Stern-/Interessen-Zählungen herunterladen

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

Lade von der Community gesammelte Sterneanzahl-Daten von jmail.world-Nutzer:innen herunter. Sterne spiegeln das Interesse der Community an bestimmten E-Mails, Dokumenten und Fotos wider.

## Rückgabewert

`pd.DataFrame` mit Daten zur Anzahl der Sterne.

## Beispiel

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

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

# Sterne nach Entitätstyp
print(stars.groupby("entity_type")["count"].sum().sort_values(ascending=False))

# Am häufigsten markierte E-Mails
email_stars = stars[stars.entity_type == "email_message"]
top = email_stars.sort_values("count", ascending=False).head(20)
```

## Spalten

| Spalte | Typ | Beschreibung |
| - | - | - |
| `entity_type` | string | Typ der Entität (`email_message`, `email_thread`, `photo`, `document`, `imessage`) |
| `entity_id` | int | ID der Entität (FK auf die entsprechende Tabelle) |
| `count` | int | Anzahl der Sterne |

## Direkte URLs

```
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.