HTTP API

Call HeadlessX directly over HTTP with standard JSON requests and API key authentication.

by @saifyxpro

Authentication

All protected routes use the same request header:

Use a normal dashboard-created API key for HTTP clients and MCP clients. Do not use the internal dashboard proxy key.

Base URLs

Common route groups

  • /api/operators/status
  • /api/operators/website/*
  • /api/operators/google/ai-search/*
  • /api/operators/tavily/*
  • /api/operators/exa/*
  • /api/operators/youtube/*
  • /api/jobs/*
  • /mcp

Example request

Good uses

  • server-to-server calls
  • internal dashboards
  • workflow tools that support raw HTTP modules
  • automation scripts and cron jobs

For route-level behavior, see API Reference.