News Report

A news report or broadcast segment. Capture the headline, what happened (the 5 Ws), key facts, people and organizations involved, sources cited, and any reported figures. Be factual and neutral. Optional fields are omitted entirely when not stated — do not infer, and never emit placeholder strings like 'not stated' or 'N/A'.

Fields

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "vidextract.predefined.news.v1",
  "title": "News Report",
  "description": "A news report or broadcast segment. Capture the headline, what happened (the 5 Ws), key facts, people and organizations involved, sources cited, and any reported figures. Be factual and neutral. Optional fields are omitted entirely when not stated — do not infer, and never emit placeholder strings like 'not stated' or 'N/A'.",
  "type": "object",
  "required": [
    "headline",
    "summary",
    "keyPoints"
  ],
  "additionalProperties": false,
  "properties": {
    "headline": {
      "type": "string",
      "description": "A concise headline capturing the main news story."
    },
    "summary": {
      "type": "string",
      "description": "Two to four sentences summarizing what happened, neutrally."
    },
    "category": {
      "type": "string",
      "enum": [
        "politics",
        "business",
        "world",
        "technology",
        "health",
        "science",
        "sports",
        "entertainment",
        "crime",
        "weather",
        "other"
      ],
      "description": "Primary news category. Omit if unclear."
    },
    "whatHappened": {
      "type": "string",
      "description": "The central event or development being reported. Omit if the segment has no single event."
    },
    "whenOccurred": {
      "type": "string",
      "description": "When the event happened or is scheduled, as stated — e.g. 'this morning', 'June 14, 2026'. Omit if not stated."
    },
    "location": {
      "type": "string",
      "description": "Where the event took place. Omit if not stated."
    },
    "keyPoints": {
      "type": "array",
      "description": "The main factual points reported, in order of importance.",
      "minItems": 1,
      "items": {
        "type": "string"
      }
    },
    "peopleInvolved": {
      "type": "array",
      "description": "Notable people named in the report.",
      "items": {
        "type": "object",
        "required": [
          "name"
        ],
        "additionalProperties": false,
        "properties": {
          "name": {
            "type": "string",
            "description": "Person's name as stated."
          },
          "role": {
            "type": "string",
            "description": "Their role, title, or relevance to the story. Omit if not stated."
          }
        }
      }
    },
    "organizations": {
      "type": "array",
      "description": "Companies, agencies, governments, or institutions involved in the story.",
      "items": {
        "type": "string"
      }
    },
    "reportedFigures": {
      "type": "array",
      "description": "Specific statistics, amounts, counts, or measurements cited in the report.",
      "items": {
        "type": "object",
        "required": [
          "value",
          "description"
        ],
        "additionalProperties": false,
        "properties": {
          "value": {
            "type": "string",
            "description": "The figure as stated — e.g. '3 million', '$2.4 billion', '12%'."
          },
          "description": {
            "type": "string",
            "description": "What the figure measures."
          }
        }
      }
    },
    "sourcesCited": {
      "type": "array",
      "description": "Sources, officials, witnesses, or outlets the report attributes information to.",
      "items": {
        "type": "string"
      }
    },
    "quotes": {
      "type": "array",
      "description": "Direct quotes from people in the report, verbatim.",
      "items": {
        "type": "object",
        "required": [
          "quote"
        ],
        "additionalProperties": false,
        "properties": {
          "quote": {
            "type": "string",
            "description": "The statement, verbatim."
          },
          "speaker": {
            "type": "string",
            "description": "Who said it. Omit if unclear."
          }
        }
      }
    }
  }
}

Use it via the API

Pass schemaId: "vidextract.predefined.news.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.news.v1"}'

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