search_metadata
Find photos and videos by metadata criteria such as city, camera model, date range, or favorites. Use when you know specific EXIF fields to filter your library.
Instructions
Search assets by EXIF metadata fields. Use this when you know specific criteria like city, camera model, or date range. For natural language visual queries (e.g. 'sunset at the beach'), use search_smart instead. For browsing without criteria, use list_assets. Read-only.
Args:
city: City name from EXIF GPS reverse-geocoding (case-sensitive, e.g. 'Barcelona').
state: State or region name.
country: Country name (e.g. 'Spain', 'Egypt').
make: Camera manufacturer (e.g. 'Apple', 'Canon', 'Sony').
model: Camera model string (e.g. 'iPhone 14 Pro', 'EOS R5').
taken_after: ISO date — return only assets captured after this date.
taken_before: ISO date — return only assets captured before this date.
is_favorite: If true, only return favorites.
asset_type: 'IMAGE' or 'VIDEO'. Omit for both.
page: Page number, starting from 1 (default 1).
size: Results per page (1-200, default 50).
Returns: JSON with total match count, current page, and assets array with IDs, filenames, and dates.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | ||
| state | No | ||
| country | No | ||
| make | No | ||
| model | No | ||
| taken_after | No | ||
| taken_before | No | ||
| is_favorite | No | ||
| asset_type | No | ||
| page | No | ||
| size | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |