{
  "openapi": "3.1.0",
  "info": {
    "title": "Pitch Score by Agentropolis",
    "version": "0.1.0",
    "summary": "Score a video / elevator pitch script 0-100 on 7 recruiter criteria (hook, clarity, proof, specificity, relevance, close, pacing) with reasons, the 3 highest-impact fixes and a stronger opening line. Text only, no rewrite, no video.",
    "contact": {
      "name": "Agentropolis",
      "url": "https://agentropolis.io"
    },
    "x-guidance": "POST {\"pitchText\":\"...\",\"targetRole\":\"optional\"}; pay the x402 402; read overall, grade, topFixes and betterOpeningLine. For a full rewrite use POST /api/rewrite."
  },
  "servers": [
    {
      "url": "https://seenly-pitch-kit.vercel.app"
    }
  ],
  "paths": {
    "/api/score": {
      "post": {
        "operationId": "scorePitch",
        "summary": "Score a pitch script",
        "tags": [
          "Careers"
        ],
        "description": "$1.00 USDC per call on Base mainnet. Cards coming soon. Invalid input → 4xx before payment. Settles only on success. 10 req/min per client.",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "1.00"
          },
          "protocols": [
            {
              "x402": {}
            }
          ],
          "rails": [
            {
              "protocol": "x402",
              "version": 2,
              "scheme": "exact",
              "network": "eip155:8453",
              "networkName": "Base mainnet",
              "asset": "USDC",
              "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "amount": "1000000",
              "priceUsd": "1.00",
              "payTo": "0xeE6239F3E17bEBe5e89F21F29D74D68CAa0d78CE",
              "facilitator": "Coinbase CDP (gas sponsored; payer needs no ETH)",
              "header": "PAYMENT-SIGNATURE"
            }
          ]
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Request"
              },
              "example": {
                "pitchText": "Hi, I'm Maya. I'm a registered nurse with seven years in critical care. As charge nurse in a medical ICU I lead a team of nine each shift, and I designed a bedside handoff checklist that cut medication handoff errors by 38 percent. I've also precepted fourteen new graduates. I'm looking for an ICU charge nurse role where safety culture matters. Let's talk.",
                "targetRole": "ICU Charge Nurse"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Score",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Result"
                }
              }
            }
          },
          "400": {
            "description": "invalid_request (not charged)"
          },
          "402": {
            "description": "Payment required (x402 v2 PAYMENT-REQUIRED header)"
          },
          "413": {
            "description": "too long (not charged)"
          },
          "422": {
            "description": "too short (not charged)"
          },
          "429": {
            "description": "rate_limited"
          },
          "502": {
            "description": "generation_failed (not charged)"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Request": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "pitchText"
        ],
        "properties": {
          "pitchText": {
            "type": "string",
            "minLength": 80,
            "maxLength": 4000,
            "description": "The spoken video-pitch / elevator-pitch script to score (caller's own text)."
          },
          "targetRole": {
            "type": "string",
            "maxLength": 120,
            "description": "Optional role the pitch targets."
          }
        }
      },
      "Result": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string",
            "const": "pitch_score"
          },
          "overall": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "description": "Weighted score (hook 20, proof 20, clarity 15, specificity 15, relevance 10, close 10, pacing 10)."
          },
          "grade": {
            "type": "string",
            "enum": [
              "A",
              "B",
              "C",
              "D",
              "F"
            ]
          },
          "dimensions": {
            "type": "object",
            "properties": {
              "hook": {
                "type": "object",
                "properties": {
                  "score": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10
                  },
                  "why": {
                    "type": "string"
                  }
                }
              },
              "clarity": {
                "type": "object",
                "properties": {
                  "score": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10
                  },
                  "why": {
                    "type": "string"
                  }
                }
              },
              "proof": {
                "type": "object",
                "properties": {
                  "score": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10
                  },
                  "why": {
                    "type": "string"
                  }
                }
              },
              "specificity": {
                "type": "object",
                "properties": {
                  "score": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10
                  },
                  "why": {
                    "type": "string"
                  }
                }
              },
              "relevance": {
                "type": "object",
                "properties": {
                  "score": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10
                  },
                  "why": {
                    "type": "string"
                  }
                }
              },
              "close": {
                "type": "object",
                "properties": {
                  "score": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10
                  },
                  "why": {
                    "type": "string"
                  }
                }
              },
              "pacing": {
                "type": "object",
                "properties": {
                  "score": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10
                  },
                  "why": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "topFixes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "minItems": 3,
            "maxItems": 3
          },
          "strongestLine": {
            "type": "string"
          },
          "betterOpeningLine": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "stats": {
            "type": "object",
            "properties": {
              "wordCount": {
                "type": "integer"
              },
              "estimatedSeconds": {
                "type": "number"
              },
              "lengthOk": {
                "type": "boolean"
              }
            }
          },
          "pricing": {
            "type": "object"
          }
        },
        "required": [
          "object",
          "overall",
          "grade",
          "dimensions",
          "topFixes"
        ]
      }
    }
  }
}