photos() - Jmail Data API

client.photos() -> pd.DataFrame

Download photo metadata including filenames, dimensions, and AI-generated descriptions.

Returns

pd.DataFrame with photo metadata.

Example

from jmail import JmailClient

client = JmailClient()
photos = client.photos()

# Photos with descriptions mentioning "pool"
pool = photos[photos.image_description.str.contains("pool", case=False, na=False)]

Columns

Column	Type	Description
`id`	int	Unique photo ID
`source`	string	Source identifier
`release_batch`	string	Volume/batch
`original_filename`	string	Original filename
`content_type`	string	MIME type
`width`	int	Image width in pixels
`height`	int	Image height in pixels
`image_description`	string	AI-generated description

Direct URLs

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