{
  "openapi": "3.1.0",
  "info": {
    "title": "Needo Marketplace API",
    "description": "Public catalog, discovery, and machine payment endpoints for Needo online marketplace and auctions in the United States.",
    "version": "1.0.0"
  },
  "x-service-info": {
    "categories": [
      "e-commerce",
      "marketplace",
      "auctions",
      "services"
    ]
  },
  "servers": [
    {
      "url": "https://needo.shop",
      "description": "Production server"
    }
  ],
  "paths": {
    "/explore": {
      "get": {
        "summary": "Explore products catalog",
        "responses": {
          "200": {
            "description": "Products catalog page"
          }
        }
      }
    },
    "/auctions": {
      "get": {
        "summary": "Live auctions catalog",
        "responses": {
          "200": {
            "description": "Live auctions page"
          }
        }
      }
    },
    "/services": {
      "get": {
        "summary": "Professional services directory",
        "responses": {
          "200": {
            "description": "Services directory page"
          }
        }
      }
    },
    "/api/agent/purchase": {
      "post": {
        "summary": "Agent-native purchase and order placement",
        "description": "Allows AI agents to execute direct purchases via Machine Payment Protocol (MPP) or x402.",
        "x-payment-info": {
          "intent": "charge",
          "method": "stripe",
          "amount": 0.01,
          "currency": "USD",
          "description": "Agent marketplace order transaction"
        },
        "responses": {
          "200": {
            "description": "Order confirmed"
          },
          "402": {
            "description": "Payment Required"
          }
        }
      }
    },
    "/api/agent/session": {
      "post": {
        "summary": "Create payable agent checkout session",
        "description": "Creates an authorized payment session for streaming or batch agent operations.",
        "x-payment-info": {
          "intent": "session",
          "method": "card",
          "amount": 1.0,
          "currency": "USD",
          "description": "Payable agent checkout session"
        },
        "responses": {
          "200": {
            "description": "Session created"
          },
          "402": {
            "description": "Payment Required"
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "LLM context and platform documentation",
        "responses": {
          "200": {
            "description": "llms.txt formatted markdown"
          }
        }
      }
    }
  }
}