Developers

Integrate the real world into your application or agent with the Outgoing API.

Overview

The Outgoing API provides a seamless REST interface to access our curated catalog of local experiences, personalized activity recommendations, and booking/reservation integrations.

API Documentation

Our comprehensive API reference, including schemas, endpoints, and interactive examples, is available in our developer portal.

For AI Agents & LLMs

Building an agent? Point it at the machine-readable spec rather than this page, which follows the llms.txt convention:

• /llms.txt — a Markdown index of every endpoint.
• /llms-full.txt — the full reference: every endpoint and schema as plain Markdown.
• openapi.json — the raw OpenAPI specification.

Authentication

All API calls require authentication credentials. There are three kinds:

• Self-serve bearer token— the default API key standard; request one from the “Get an API key” flow below. The key is bound to a single user credential and requests are personalized according to that bound user. Send the key using the Authorization: Bearer YOUR_API_KEY header.
• AAuth token — an emerging standard for cryptographic identity for AI agents, which provides agents with their own cryptographic identity -- with both identity and authorization claims in the same token -- to securely enable agents to act on behalf of users. Learn more at https://www.aauth.dev
• Platform key — for platforms acting on behalf of many end users. Each request adds X-External-User-Id to say which of your users the call is for, and you provision each user once via POST /partner/v1/users. Contact us to set one up at [email protected].

Quick start

The simplest call needs only your bearer key and a prompt:

curl -sS -G "https://api.outgoing.world/partner/v1/search" \
  --data-urlencode "prompt=fun things to do this weekend in Birmingham" \
  -H "Authorization: Bearer og_api_<your-key>"

Streaming and long-running searches

Search runs a live agentic crawl, so by default the response is streamed (stream=true): the server holds the connection open with whitespace keep-alives while the search runs, then sends the complete result as the final bytes. This prevents proxy and load-balancer idle timeouts from aborting a slow search.

Getting Access

Sign in with your Outgoing account to create an API key for your personal account with trial quota that you can start using with OpenClaw, Hermes, and other agents, or contact us for a platform integration.