search_metadata
Locate specific photos and videos by filtering EXIF metadata like city, camera model, date range, or OCR text. Narrow results with favorites, people, tags, albums, and more.
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.
ocr: Text recognized inside the image (tickets, signs, documents). Needs
OCR enabled on the server — check with get_capabilities.
person_ids: Only assets showing ALL of these people (ids from list_people).
tag_ids: Only assets carrying these tags (ids from list_tags).
album_ids: Only assets inside these albums.
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 |
|---|---|---|---|
| ocr | No | ||
| city | No | ||
| make | No | ||
| page | No | ||
| size | No | ||
| model | No | ||
| state | No | ||
| country | No | ||
| tag_ids | No | ||
| album_ids | No | ||
| asset_type | No | ||
| person_ids | No | ||
| is_favorite | No | ||
| taken_after | No | ||
| taken_before | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |