Query

Structured responses

Consume an answer with confidence and supporting evidence alongside it.

FieldTypeDescription
answerobjectQuestion-specific structured content, such as the trip_styles array in the Query example.
confidencenumberHow strongly the available evidence supports the answer.
evidenceobjectAggregate support for this question, including moment counts and history span.

The question determines the answer#

The response envelope separates the answer from its support. The content inside answer depends on the question; trip_styles is an example, not a field returned by every query().

Validate the answer shape your feature consumes and provide a fallback for missing or insufficient evidence.

Use the result in your product#

Feed validated answer fields into ranking, onboarding, or an assistant’s context. Treat them as inferences the user can correct. For repeated reads of stable understanding, use Profile.

Derived answers
Structured responses contain derived context and aggregate evidence. They do not return raw media, image-level sensitive details, or identifiers for remotely retrieving individual photos.