{
  "api": "Aoraforge Read API",
  "api_version": "v1",
  "site": "https://aoraforge.com",
  "docs": "https://aoraforge.com/api/",
  "contract": "static-read",
  "surfaces_polled": [
    {
      "id": "chatgpt",
      "name": "ChatGPT",
      "role": null
    },
    {
      "id": "perplexity",
      "name": "Perplexity",
      "role": null
    },
    {
      "id": "google_aio",
      "name": "Google AI Overviews",
      "role": null
    },
    {
      "id": "brave",
      "name": "Brave Search",
      "role": null
    }
  ],
  "endpoints": [
    {
      "method": "GET",
      "host": "https://aoraforge.com",
      "url": "https://aoraforge.com/api/v1/version.json",
      "path": "/api/v1/version.json",
      "summary": "API version + last-deployed date",
      "auth_required": false,
      "status": "live"
    },
    {
      "method": "GET",
      "host": "https://aoraforge.com",
      "url": "https://aoraforge.com/api/v1/products.json",
      "path": "/api/v1/products.json",
      "summary": "Launch products plus coming-soon product labels, with purchase details only where applicable",
      "auth_required": false,
      "status": "live"
    },
    {
      "method": "GET",
      "host": "https://aoraforge.com",
      "url": "https://aoraforge.com/api/v1/methodology.json",
      "path": "/api/v1/methodology.json",
      "summary": "Methodology essay index (slugs, titles, summaries, URLs)",
      "auth_required": false,
      "status": "live"
    },
    {
      "method": "GET",
      "host": "https://aoraforge.com",
      "url": "https://aoraforge.com/api/v1/methodology/{slug}.json",
      "path": "/api/v1/methodology/{slug}.json",
      "summary": "Single methodology essay — metadata + body excerpt + canonical URL",
      "auth_required": false,
      "status": "live"
    },
    {
      "method": "GET",
      "host": "https://aoraforge.com",
      "url": "https://aoraforge.com/api/v1/case-studies.json",
      "path": "/api/v1/case-studies.json",
      "summary": "All case studies Aoraforge operates in (active + planned)",
      "auth_required": false,
      "status": "live"
    },
    {
      "method": "GET",
      "host": "https://aoraforge.com",
      "url": "https://aoraforge.com/api/v1/samples.json",
      "path": "/api/v1/samples.json",
      "summary": "All sample reports indexed by case study + tier",
      "auth_required": false,
      "status": "live"
    },
    {
      "method": "GET",
      "host": "https://aoraforge.com",
      "url": "https://aoraforge.com/api/v1/queries/{slug}.json",
      "path": "/api/v1/queries/{slug}.json",
      "summary": "Public starter query library for an active case study (brand, buyer-intent, topical)",
      "auth_required": false,
      "status": "live"
    },
    {
      "method": "POST",
      "host": "https://my.aoraforge.com",
      "url": "https://my.aoraforge.com/api/v1/free-diagnostic",
      "path": "/api/v1/free-diagnostic",
      "summary": "Live Worker endpoint on my.aoraforge.com: trigger a Free Diagnostic run for a site + 1-5 queries. Returns run_id; poll /runs/{id} on the same Worker host",
      "auth_required": false,
      "status": "live"
    },
    {
      "method": "POST",
      "host": "https://my.aoraforge.com",
      "url": "https://my.aoraforge.com/api/v1/pro-audit",
      "path": "/api/v1/pro-audit",
      "summary": "Trigger a $149 Pro Audit run: 15 queries × 4 platforms, head-to-head against 2 competitors. Requires prior Stripe payment session reference.",
      "auth_required": false,
      "status": "planned"
    },
    {
      "method": "GET",
      "host": "https://my.aoraforge.com",
      "url": "https://my.aoraforge.com/api/v1/runs/{run_id}",
      "path": "/api/v1/runs/{run_id}",
      "summary": "Live Worker endpoint on my.aoraforge.com: poll a Free Diagnostic run for status; returns report URL when complete",
      "auth_required": false,
      "status": "live"
    }
  ],
  "last_built": "2026-05-13"
}