Search assets
Changed onSearches for assets by content, by typed structured filters on albums, people, date range, and location, or both. Content searches are ranked by relevance; filter-only searches return matches newest-first. An uploaded image adds visual-similarity search; text and uploaded-image signals stay independent when both are provided.
At least one search criterion must be provided. Location filtering is by coordinate in two mutually-exclusive modes: a radius (center + radius) or a bounding box (bbox); it narrows candidates and is not a search criterion on its own.
Request
- Base URL: https://api.gumnut.ai
- URL: https://api.gumnut.ai/api/search
- Auth: one of:
- HTTP bearer
- HTTP bearer
Query parameters
Opt-in expansion fields. Supported values: metadata (camera/EXIF/GPS and location names), faces, people, metrics (ML quality scores), file_data (a group token populating the nested file_data object with the file/provenance scalars device_asset_id, device_id, file_created_at, file_modified_at, checksum, checksum_sha1, file_size_bytes), and variants (every asset_urls rung beyond the lean one. Without it asset_urls carries only its lean rung — thumbnail for an image, or thumbnail_image for a video — so callers that render non-thumbnail variants or download the current rendering must pass it). Accepts multiple include= query params or a single comma-delimited value (e.g. include=faces,people). Unknown values return 422. When omitted, only the lean core is returned (id, mime_type, local_datetime, dimensions, description, thumbhash, asset_urls, kind, current_version_id) and each data field above is null/absent until you request it.
Response
Successful Response
Changes
- breaking
response property
detaillist-of-types was widened by adding typesstringto media typeapplication/jsonof response422 - info
the response property
became required for the status
- breaking
- warning
removed the request property
- warning
removed the optional property
from the response with the status
- warning