Core API

POST /research

Research 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"
  }'
questionstring

The question the report should investigate and answer.

scopestring | geometry

The geographic scope for the investigation.

depthstring

Controls 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.