Thetawaves AI — Developer Docs

Programmatically scan any website for AI-readiness and Answer Engine Optimization (AEO), then retrieve a structured report of scores and fix recommendations.

Overview

The Thetawaves AI REST API lets agents and applications create scans and read back results. The full machine-readable contract is published as an OpenAPI 3.1 document at https://thetawaves.ai/openapi.json.

Authentication

The public scan endpoints are open and require no credentials. For higher-volume access, send your agency code on the request body, or contact support@thetawaves.ai for an API key, which is supplied as a Bearer token:

Authorization: Bearer YOUR_API_KEY

Create a scan

Submit a URL to analyze. The scan runs asynchronously.

curl -X POST https://thetawaves.ai/api/scans \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

JavaScript (fetch)

const res = await fetch("https://thetawaves.ai/api/scans", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://example.com" }),
});
const scan = await res.json();

Retrieve a scan

Poll the scan by its numeric id until status becomes completed.

curl https://thetawaves.ai/api/scans/123

List categories

Industry categories used for AI visibility analysis.