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

# imessage_conversations() / imessage_messages()

> Scarica i dati delle conversazioni e dei messaggi iMessage

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

Scarica i dati di iMessage recuperati dall’archivio di Epstein, suddivisi in conversazioni (contatti) e singoli messaggi.

## Esempio

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

client = JmailClient()
convos = client.imessage_conversations()
messages = client.imessage_messages()

# All messages from a specific conversation
ghislaine = messages[messages.conversation_slug == "ghislaine-maxwell"]

# Messages sent by Epstein
sent = messages[messages.sender == "me"]

# Unisce i messaggi con i metadati della conversazione
merged = messages.merge(
    convos[["slug", "name"]],
    left_on="conversation_slug",
    right_on="slug",
    how="left"
)
```

## Colonne della conversazione

| Colonna | Tipo | Descrizione |
| - | - | - |
| `id` | int | ID univoco della conversazione |
| `slug` | string | Identificatore della conversazione compatibile con URL |
| `name` | string | Nome del contatto |
| `bio` | string | Bio/descrizione del contatto |
| `photo` | string | URL della foto del contatto |
| `last_message` | string | Anteprima dell'ultimo messaggio |
| `last_message_time` | string | Timestamp dell'ultimo messaggio |
| `pinned` | bool | Se la conversazione è stata fissata in alto |
| `confirmed` | bool | Se l'identità del contatto è confermata |
| `source_files` | json | File di origine da cui è stata estratta questa conversazione |
| `message_count` | int | Numero totale di messaggi in questa conversazione |

## Colonne dei messaggi

| Column | Type | Description |
| - | - | - |
| `id` | string | ID univoco del messaggio (`{slug}#{index}`) |
| `conversation_slug` | string | FK alle conversazioni (slug) |
| `message_index` | int | Posizione del messaggio all'interno della conversazione |
| `text` | string | Contenuto testuale del messaggio |
| `sender` | string | `me` (Epstein) oppure `them` (contatto) |
| `time` | string | Stringa di timestamp originale |
| `timestamp` | timestamp | Timestamp elaborato |
| `source_file` | string | File di origine da cui è stato estratto questo messaggio |
| `sender_name` | string | Nome visualizzato del mittente |

## URL diretti

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.