Start

Getting started

Give your application a perception layer with one physical-world query.

Create API key

Open your developer account to create or manage API keys.

Create API key

Before you start

  1. 1

    Create an API key

    Open your Outerview developer account and create a server-side API key.

  2. 2

    Store it securely

    Set OUTERVIEW_API_KEY in your environment. Never expose the key in browser or mobile code.

  3. 3

    Call Discover

    Send a POST request to https://api.outerview.ai/v1/compute with a physical-world question.

Make your first query

The request remains open while Outerview observes, retrieves, and encodes the physical-world context. A successful response contains a structured answer and GeoJSON together.

Terminal
curl -X POST https://api.outerview.ai/v1/compute \
  -H "Authorization: Bearer $OUTERVIEW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "coffee shops near parks in Toronto",
    "limit": 100,
    "answer": true,
    "coordinates": [
      { "name": "Downtown Toronto", "latitude": 43.6532, "longitude": -79.3832 }
    ]
  }'

Choose an interface

REST APIHTTP

Query physical-world context over HTTP from services, pipelines, and language-independent integrations.

JavaScript SDKNode.js 20+

Embed physical perception directly in Node.js with JSON, multipart uploads, authentication, and timeouts handled.

CLITerminal

Query the world from your terminal for prototyping, testing, export, and pipeline scripts.

MCP serverAI agents

Wire physical perception into MCP-compatible assistants and agent runtimes.