Science Experiment

A science experiment or demonstration extracted from a video. Capture the procedure, the science behind it, and any safety notes. Only record what the presenter states; omit anything not mentioned and do not infer.

Fields

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "vidextract.predefined.science.v1",
  "title": "Science Experiment",
  "description": "A science experiment or demonstration extracted from a video. Capture the procedure, the science behind it, and any safety notes. Only record what the presenter states; omit anything not mentioned and do not infer.",
  "type": "object",
  "required": [
    "title",
    "summary",
    "procedure"
  ],
  "additionalProperties": false,
  "properties": {
    "title": {
      "type": "string",
      "description": "Name of the experiment or demonstration, e.g. 'Fire tornado demonstration'."
    },
    "summary": {
      "type": "string",
      "description": "One to three sentences describing what is demonstrated and the observed result."
    },
    "field": {
      "type": "string",
      "description": "Scientific field, lowercased, e.g. 'physics', 'chemistry', 'biology'. Omit if unclear."
    },
    "concepts": {
      "type": "array",
      "description": "Scientific principles or concepts illustrated, e.g. 'surface tension', 'combustion', 'centripetal force'.",
      "items": {
        "type": "string"
      }
    },
    "hypothesis": {
      "type": "string",
      "description": "The question or hypothesis the experiment tests, if stated. Omit if not stated — do not infer."
    },
    "audienceLevel": {
      "type": "string",
      "enum": [
        "kids",
        "school",
        "general",
        "advanced"
      ],
      "description": "Intended audience level if clear. Omit if unsure."
    },
    "materials": {
      "type": "array",
      "description": "Materials, substances, or apparatus used, lowercased, e.g. 'dish soap', 'iron filings', 'beaker'.",
      "items": {
        "type": "string"
      }
    },
    "procedure": {
      "type": "array",
      "description": "Ordered steps to perform the experiment or demonstration.",
      "minItems": 1,
      "items": {
        "type": "object",
        "required": [
          "text"
        ],
        "additionalProperties": false,
        "properties": {
          "text": {
            "type": "string",
            "description": "Imperative instruction, e.g. 'Add a drop of soap to the center of the water.'"
          },
          "detail": {
            "type": "string",
            "description": "Extra clarifying detail if the presenter elaborates. Omit if self-contained."
          },
          "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}$"
          }
        }
      }
    },
    "observation": {
      "type": "string",
      "description": "What is observed to happen during the experiment. Omit if not clearly stated."
    },
    "explanation": {
      "type": "string",
      "description": "The scientific explanation for why the result occurs, as given by the presenter. Omit if not stated."
    },
    "realWorldApplications": {
      "type": "array",
      "description": "Real-world examples or applications of the principle mentioned. Short phrases.",
      "items": {
        "type": "string"
      }
    },
    "safetyNotes": {
      "type": "array",
      "description": "Safety warnings or precautions stated by the presenter. Short phrases. Omit if none.",
      "items": {
        "type": "string"
      }
    },
    "tips": {
      "type": "array",
      "description": "Tips for getting the experiment to work or variations to try.",
      "items": {
        "type": "string"
      }
    }
  }
}

Use it via the API

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

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