> ## 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()

> Download identified people from facial recognition

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

Download people identified through AWS Rekognition facial recognition analysis.

## Returns

`pd.DataFrame` with people data.

## Example

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

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

# People with the most photo appearances
top = people.sort_values("photo_count", ascending=False).head(20)
print(top[["name", "photo_count"]])
```

## Columns

| Column        | Type   | Description                             |
| ------------- | ------ | --------------------------------------- |
| `id`          | int    | Unique person ID                        |
| `name`        | string | Identified name                         |
| `source`      | string | Detection source                        |
| `photo_count` | int    | Number of photos containing this person |

## Direct URLs

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