Group Related Questions
All questions in a request share one set of retrieved evidence. Group questions about the same entity or topic; use separate requests for unrelated entities.Citations
Each object in thecitations array has these fields:
Excerpts are included by default. Set
advanced_settings.include_excerpts: false to return
"excerpts": [] for each citation. URLs and available titles are still returned;
the decision still uses the excerpts as evidence.
The former top-level include_excerpts is still accepted. Do not send both forms.
Input Limits
See the API Reference
for the complete request and response schemas.
Limit Evidence by Date
Add"advanced_settings": {"after_date": "2026-10-01"} to limit grounding
evidence to content published on or after a date. Use an RFC 3339 date in
YYYY-MM-DD format. Omit after_date when older evidence is still relevant.
Location
Add"advanced_settings": {"location": "gb"} to geo-target the grounding search.
Use a supported country code.
Codes are case-insensitive; use gb for the United Kingdom, not uk.
advanced_settings accepts location, after_date, include_excerpts, or any
combination of those fields.
Omit the object when unused. Empty settings or invalid values return HTTP 422.