Core API
POST /researchResearch the Earth
Ask open-ended questions about our world and receive reports grounded in physical evidence and Earth data.
From retrieval to understanding
Research is for questions that cannot be answered by a list of points alone. It gathers relevant observations and sources, compares evidence, and produces a structured report.
Use it for anything Earth related: urban change, infrastructure, ecosystems, climate resilience, public safety, land use, mobility, or conditions in a specific place.
Start a research task
POST /research
curl "$OUTERVIEW_API_URL/research" \
-H "Authorization: Bearer $OUTERVIEW_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"question": "Where is extreme heat risk increasing fastest in Toronto?",
"scope": "Toronto, Canada",
"depth": "standard"
}'questionstringThe question the report should investigate and answer.
scopestring | geometryThe geographic scope for the investigation.
depthstringControls the breadth of evidence and report detail.
Reports and evidence
- A direct answer and executive summary.
- Key findings organized by theme or geography.
- Supporting locations, imagery, datasets, and source references.
- Limitations and confidence signals where evidence is incomplete.