Skip to main content
client.photo_faces() -> pd.DataFrame
Download face bounding boxes that link detected faces in photos to identified people.

​
Returns

pd.DataFrame with face detection data.

​
Example

from jmail import JmailClient

client = JmailClient()
faces = client.photo_faces()
people = client.people()

# Join to get person names
import pandas as pd
merged = faces.merge(people[["id", "name"]], left_on="person_id", right_on="id", suffixes=("", "_person"))
print(merged.groupby("name").size().sort_values(ascending=False).head(20))

​
Columns

ColumnTypeDescription
idintUnique face detection ID
photo_idintFK to photos table
person_idintFK to people table
bbox_leftfloatBounding box left edge (normalized 0-1)
bbox_topfloatBounding box top edge (normalized 0-1)
bbox_widthfloatBounding box width (normalized 0-1)
bbox_heightfloatBounding box height (normalized 0-1)
confidencefloatDetection confidence score

​
Direct URLs

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