Skip to main content
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 the citations 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.