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

# people()

> Scarica i soggetti identificati tramite riconoscimento facciale

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

Scarica le persone identificate tramite analisi di riconoscimento facciale con AWS Rekognition.

## Valore restituito

`pd.DataFrame` con i dati sulle persone.

## Esempio

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

client = JmailClient()
people = client.people()

# Persone con più apparizioni in foto
top = people.sort_values("photo_count", ascending=False).head(20)
print(top[["name", "photo_count"]])
```

## Colonne

| Colonna | Tipo | Descrizione |
| - | - | - |
| `id` | int | ID univoco della persona |
| `name` | string | Nome identificato |
| `source` | string | Origine del rilevamento |
| `photo_count` | int | Numero di foto che includono questa persona |

## URL diretti

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


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