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

# photos()

> Download photo metadata

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

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

## Returns

`pd.DataFrame` with photo metadata.

## Example

```python theme={null}
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
```