{
  "name": "Readyt Public API",
  "description": "Reddit thread discovery and AI visibility (GEO) analysis for a brand or domain. Start an analysis, poll it, read the result.",
  "version": "v1",
  "versions": {
    "v1": {
      "status": "current",
      "since": "2026-08-23",
      "deprecation": null,
      "sunset": null,
      "successor": null
    }
  },
  "versioning": {
    "scheme": "url-path",
    "pattern": "https://www.readyt.ai/api/{version}/...",
    "current": "v1",
    "policy_url": "https://www.readyt.ai/developers#versioning",
    "breaking_changes": "Breaking changes ship under a new path version. The previous version keeps working for at least 6 months, during which every response carries Deprecation and Sunset headers plus a Link rel=\"successor-version\".",
    "additive_changes": "New fields and new endpoints can appear inside a version without notice. Ignore unknown fields."
  },
  "rate_limits": {
    "gateway": [
      {
        "policy": "read",
        "limit": 60,
        "window_seconds": 60
      },
      {
        "policy": "write",
        "limit": 10,
        "window_seconds": 3600
      }
    ],
    "upstream_daily_quotas": {
      "analyses": {
        "global_per_day": 250,
        "per_email_per_tool_per_day": 4
      },
      "leads": {
        "global_per_day": 150,
        "per_email_per_day": 2
      }
    },
    "headers": [
      "RateLimit",
      "RateLimit-Policy",
      "RateLimit-Limit",
      "RateLimit-Remaining",
      "RateLimit-Reset",
      "Retry-After"
    ]
  },
  "authentication": {
    "required": false,
    "note": "Open endpoints. A contact email is required on write calls so the report can be delivered."
  },
  "endpoints": {
    "discovery": {
      "method": "GET",
      "url": "https://www.readyt.ai/api/v1"
    },
    "tools": {
      "method": "GET",
      "url": "https://www.readyt.ai/api/v1/tools"
    },
    "start_analysis": {
      "method": "POST",
      "url": "https://www.readyt.ai/api/v1/analyses"
    },
    "get_analysis": {
      "method": "GET",
      "url": "https://www.readyt.ai/api/v1/analyses?id={id}"
    },
    "start_lead_discovery": {
      "method": "POST",
      "url": "https://www.readyt.ai/api/v1/leads"
    },
    "get_lead_discovery": {
      "method": "GET",
      "url": "https://www.readyt.ai/api/v1/leads?id={id}"
    }
  },
  "documentation": {
    "openapi": "https://www.readyt.ai/openapi.json",
    "developer_docs": "https://www.readyt.ai/developers",
    "mcp_manifest": "https://www.readyt.ai/.well-known/mcp.json",
    "mcp_endpoint": "https://www.readyt.ai/api/mcp",
    "llms_txt": "https://www.readyt.ai/llms.txt"
  }
}