Developer preview: this API specification is not a production availability claim.
NAVIGATOR / DEVELOPER PLATFORM

A simpler way
into the web.

Navigator's future-facing HTTP API and MCP surface are hosted under one product domain, separate from the Owner's private operations. Read-only Fetch can be tested in an isolated local deployment. AI/browser integrations require independent production infrastructure.

API routes

GET /healthService health, without internal host details.
GET /v1/capabilitiesMachine-readable feature readiness. Trust this instead of marketing copy.
GET /v1/sessionValidate a Navigator-only invite key and return its non-secret identity and allowed domains.
POST /v1/fetchRetrieve a public HTTPS page as bounded structured data. Requires a product identity, or a separately enabled guest trial.
POST /v1/searchStructured search through an independently configured provider.
POST /mcpNavigator-only MCP tools with a separate user identity and scope, never HUNTER Owner operations.

Fetch request

JSON / HTTPS REQUEST
POST https://navigator.hunterall.com/v1/fetch
Authorization: Bearer <your-navigator-access>
Content-Type: application/json

{
  "url": "https://example.com/"
}

Search request

JSON / HTTPS REQUEST
POST https://navigator.hunterall.com/v1/search
Authorization: Bearer <your-navigator-access>
Content-Type: application/json

{
  "query": "nail trends Berlin",
  "max_results": 5
}

Search appears only after the operator connects a valid server-side SearXNG endpoint and durable Navigator metering. The endpoint cannot be supplied by a caller. Provider egress is bounded by the active deployment contract; meter failure denies before egress. Guest Search remains disabled.

Free guest trial

The website workspace can offer a small free Fetch trial. It only works from the Navigator website, never cross-site:

GET /v1/guest-sessionREADY if your browser already has a session, otherwise CHALLENGE_REQUIRED with a Cloudflare Turnstile site key.
POST /v1/guest-sessionBody {"token":"<turnstile token>"}. On success sets a signed, HttpOnly session cookie valid for 24 hours.
403 CHALLENGE_FAILEDHuman check not accepted. Retry the check.
429 SESSION_DAILY_LIMIT / GLOBAL_DAILY_LIMITFree quota used up for today (UTC). Use an API identity for more.
503Verification or metering temporarily unavailable. Navigator fails closed and never runs an unmetered request.

Identity and safety

Tokens are intended to be scoped to Navigator only, with per-tenant usage and origin restrictions. The public launch will require independently verified authentication, durable quotas, private-data handling and external tests. The system never shares its issuer, keys or session state with HUNTER OS.

Feature maturity

Search/Fetch source and MCP adapters are candidate-level components. Browser, AI Agent, profile management, vault, research, datasets, monitoring and run history are in implementation planning. The website will not claim they work until they pass production verification.

โ† Back to Navigator