Skip to main content
client.emails(slim=False) -> pd.DataFrame
Download the email archive as a pandas DataFrame.

Parameters

slim
bool
default:"False"
When True, returns a smaller dataset without body text columns (content_markdown, content_html). Ideal for network analysis, sender/recipient graphs, and timeline visualizations.

Returns

pd.DataFrame with columns depending on the slim parameter.

Example

from jmail import JmailClient

client = JmailClient()

# Full dataset with body text
df = client.emails()

# Slim: no body text, much smaller download
df = client.emails(slim=True)

# Filter to Epstein-sent emails
sent = df[df.epstein_is_sender == True]
print(f"Epstein sent {len(sent)} emails")

Columns (slim)

ColumnTypeDescription
idintUnique email ID
doc_idstringThread grouping ID
senderstringSender email/name
subjectstringEmail subject line
to_recipientsjsonTo recipients
cc_recipientsjsonCC recipients
bcc_recipientsjsonBCC recipients
sent_attimestampSend date
account_emailstringSource account
email_drop_idstringSource identifier
epstein_is_senderboolWhether Epstein sent this email

Additional Columns (full)

ColumnTypeDescription
content_markdownstringEmail body as Markdown
content_htmlstringEmail body as HTML
attachmentsintNumber of attachments

Direct URLs

https://data.jmail.world/v1/emails.parquet
https://data.jmail.world/v1/emails-slim.parquet
https://data.jmail.world/v1/emails.ndjson.gz
https://data.jmail.world/v1/emails-slim.ndjson.gz