Motivational Speech

A motivational speech or talk extracted from a video. Captures the core message, key points, memorable quotes, the call to action, and rhetorical devices. Optional fields are omitted when the speaker does not state them — do not infer.

Fields

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "vidextract.predefined.motivation.v1",
  "title": "Motivational Speech",
  "description": "A motivational speech or talk extracted from a video. Captures the core message, key points, memorable quotes, the call to action, and rhetorical devices. Optional fields are omitted when the speaker does not state them — do not infer.",
  "type": "object",
  "required": [
    "title",
    "coreMessage",
    "keyPoints"
  ],
  "additionalProperties": false,
  "properties": {
    "title": {
      "type": "string",
      "description": "Short title capturing the speech's subject."
    },
    "speaker": {
      "type": "string",
      "description": "Name of the speaker if identified. Omit otherwise."
    },
    "coreMessage": {
      "type": "string",
      "description": "The central thesis of the speech in one or two sentences — the single idea the listener should leave with."
    },
    "themes": {
      "type": "array",
      "description": "Major themes, lowercased.",
      "uniqueItems": true,
      "items": {
        "type": "string",
        "enum": [
          "discipline",
          "perseverance",
          "mindset",
          "self-belief",
          "hard-work",
          "failure",
          "fear",
          "purpose",
          "success",
          "growth",
          "consistency",
          "responsibility",
          "gratitude",
          "courage",
          "focus",
          "resilience",
          "ambition",
          "habits"
        ]
      }
    },
    "tone": {
      "type": "string",
      "enum": [
        "inspiring",
        "intense",
        "aggressive",
        "calm",
        "tough-love",
        "reflective",
        "uplifting",
        "urgent"
      ],
      "description": "Dominant emotional tone of the delivery. Pick the single best fit. Omit if unclear."
    },
    "targetAudience": {
      "type": "string",
      "description": "Who the speech is aimed at if stated, e.g. 'students', 'entrepreneurs', 'anyone feeling stuck'. Omit otherwise."
    },
    "keyPoints": {
      "type": "array",
      "description": "The main arguments or lessons, in the order delivered.",
      "minItems": 1,
      "items": {
        "type": "object",
        "required": [
          "point"
        ],
        "additionalProperties": false,
        "properties": {
          "point": {
            "type": "string",
            "description": "A single lesson or argument the speaker makes, stated concisely."
          },
          "explanation": {
            "type": "string",
            "description": "How the speaker supports or expands this point, if elaborated. Omit otherwise."
          },
          "videoTimestamp": {
            "type": "string",
            "description": "Start timestamp in source video, 'mm:ss' or 'h:mm:ss'. Omit if unknown.",
            "pattern": "^(\\d{1,2}:)?\\d{1,2}:\\d{2}$"
          }
        }
      }
    },
    "memorableQuotes": {
      "type": "array",
      "description": "Punchy, quotable lines captured verbatim from the speech.",
      "items": {
        "type": "object",
        "required": [
          "quote"
        ],
        "additionalProperties": false,
        "properties": {
          "quote": {
            "type": "string",
            "description": "The line as spoken, verbatim."
          },
          "videoTimestamp": {
            "type": "string",
            "description": "Start timestamp in source video, 'mm:ss' or 'h:mm:ss'. Omit if unknown.",
            "pattern": "^(\\d{1,2}:)?\\d{1,2}:\\d{2}$"
          }
        }
      }
    },
    "callToAction": {
      "type": "string",
      "description": "The specific action the speaker urges the listener to take. Omit if none is given."
    },
    "stories": {
      "type": "array",
      "description": "Anecdotes, examples, or stories the speaker uses to illustrate points.",
      "items": {
        "type": "object",
        "required": [
          "summary"
        ],
        "additionalProperties": false,
        "properties": {
          "summary": {
            "type": "string",
            "description": "Brief summary of the story or example."
          },
          "lesson": {
            "type": "string",
            "description": "The takeaway the speaker draws from it. Omit if not explicit."
          }
        }
      }
    },
    "actionableTakeaways": {
      "type": "array",
      "description": "Concrete things the listener can actually do, distilled from the speech.",
      "items": {
        "type": "string"
      }
    },
    "peopleReferenced": {
      "type": "array",
      "description": "Notable people, role models, or figures the speaker cites as examples.",
      "items": {
        "type": "string"
      }
    }
  }
}

Use it via the API

Pass schemaId: "vidextract.predefined.motivation.v1" when you submit an extraction. The call returns an id immediately. Poll GET /v1/extractions/{id}/result (or register a webhook) for the structured result.

curl -s -X POST https://postreef.com/v1/extractions \
  -H "x-api-key: $VIDEXTRACT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
       "inputs": ["transcript", "comments"],
       "schemaId": "vidextract.predefined.motivation.v1"}'

Full request/response shape in the API reference; copy-paste poll loops in the API quickstart.