Skip to main content
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

ColumnTypeDescription
idintUnique photo ID
sourcestringSource identifier
release_batchstringVolume/batch
original_filenamestringOriginal filename
content_typestringMIME type
widthintImage width in pixels
heightintImage height in pixels
image_descriptionstringAI-generated description

​
Direct URLs

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