Skip to main content
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

ColumnTypeDescription
entity_typestringEntity type (email_message, email_thread, photo, document, imessage)
entity_idintEntity ID (FK to corresponding table)
countintNumber of stars

Direct URLs

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