star_counts() - Jmail Data API

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

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