{
  "openapi": "3.1.0",
  "info": {
    "title": "WebsDocs ASG Directory API",
    "version": "2.5.0",
    "description": "Public APIs for business discovery, machine-readable business profiles, country coverage, aggregate analytics, public activity, globe/network data, website audits, and review-controlled listing workflows."
  },
  "servers": [
    {
      "url": "https://asg.websdocs.com/directory"
    }
  ],
  "paths": {
    "/api/bootstrap": {
      "get": {
        "summary": "One-call public frontend bootstrap"
      }
    },
    "/api/directory": {
      "get": {
        "summary": "Search public directory listings"
      }
    },
    "/api/analytics": {
      "get": {
        "summary": "Read global public-safe directory and crawl analytics",
        "parameters": [
          {
            "name": "days",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 90
            }
          }
        ]
      }
    },
    "/api/globe": {
      "get": {
        "summary": "Read located country-centroid points, unlocated public listing totals, and real public activity"
      }
    },
    "/api/locations": {
      "get": {
        "summary": "Read public geographic coverage"
      }
    },
    "/api/activity": {
      "get": {
        "summary": "Read public activity records, pulse and growth"
      }
    },
    "/api/website-audit": {
      "post": {
        "summary": "Run a live public website audit with optional email report"
      }
    },
    "/api/categories": {
      "get": {
        "summary": "Read directory categories"
      }
    },
    "/api/stats": {
      "get": {
        "summary": "Read public headline statistics"
      }
    },
    "/business/{slug}.json": {
      "get": {
        "summary": "Read one public business profile"
      }
    },
    "/api/listings/submit": {
      "post": {
        "summary": "Submit a free listing and continue into secure owner verification"
      }
    },
    "/api/listings/claim": {
      "post": {
        "summary": "Claim a public listing and continue into secure owner verification"
      }
    },
    "/api/claims/{claimId}/verification/start": {
      "post": {
        "summary": "Start or regenerate a claim verification challenge"
      }
    },
    "/api/claims/{claimId}/verification/check": {
      "post": {
        "summary": "Check DNS or website ownership evidence"
      }
    },
    "/api/claims/{claimId}/verification/status": {
      "post": {
        "summary": "Read claim verification status using the temporary claim-session bearer token"
      }
    },
    "/owner/verification": {
      "get": {
        "summary": "Secure Directory Owner verification workspace"
      }
    },
    "/owner/activate": {
      "get": {
        "summary": "One-time Directory Owner account activation"
      }
    },
    "/owner/login": {
      "get": {
        "summary": "Directory Owner login"
      }
    },
    "/owner/dashboard": {
      "get": {
        "summary": "Free Directory Owner dashboard"
      }
    },
    "/api/listings/correct": {
      "post": {
        "summary": "Request a listing correction"
      }
    },
    "/api/listings/remove": {
      "post": {
        "summary": "Request removal"
      }
    }
  }
}