Media Inspector

⚡

Progressive Enrichment

Resources evolve through FAST → STANDARD → FULL enrichment stages. Completion is monotonically non-decreasing. Enrichments never regress.

🎯

Projection Profiles

FAST, STANDARD, and FULL profiles control payload visibility — not orchestration. Processing state derives only from canonical enrichment registry.

🔍

Provider-Native Intelligence

YouTube thumbnails are provider-native. Blurhash is generated. Palette is computed. Codec is extracted. Provenance is immutable.

🎵

Media-Aware Enrichment

Audio exposes waveform and spectrogram. Image exposes palette and dimensions. Video exposes bitrate and fps. Unsupported enrichments are omitted, not null.

🛡️

Schema Governance

Empty objects are forbidden. Null means known-but-unavailable. Omission means unsupported. Every namespace carries semantic meaning.

📡

Orchestration Lifecycle

Canonical enrichment state is shared across profiles. FAST and FULL for the same resource share the same job. Cache preserves projection isolation.

Inspect Any Media URL

Single endpoint. Profile-aware. Progressive enrichment.

Hosted API: https://api.urlmediainspector.dev · Swagger Explorer · OpenAPI

POST/api/v1/inspect?profile=full

json

{
  "url": "https://youtu.be/GLTTI1NFHus?si=okdNMy6_p0VSqZJG"
}

Response — Provider-native intelligence, complete enrichment

jsonc

{
  "success": true,
  "responseSource": "fresh", // "fresh" | "cache" | "inflight"
  "cached": false,
  "processing": {
    "status": "complete",
    "completion": 1,
    "enrichmentsPending": false,
    "completedStages": ["semantic", "mediaFormat", "oembed"],
    "pendingStages": [],
  },
  "data": {
    "identity": {
      "url": "https://youtu.be/GLTTI1NFHus?si=...",
      "finalUrl": "https://youtu.be/GLTTI1NFHus?si=...",
      "canonicalUrl": "https://www.youtube.com/watch?v=GLTTI1NFHus",
      "mime": "text/html",
    },
    "semantic": {
      "kind": "embed-media",
      "semanticType": "embedded-video",
      "title": "Provider Native Title",
    },
    "provider": {
      "name": "youtube",
      "confidence": 1,
      "detectionMethod": "url-parser",
    },
    "playback": {
      "strategy": "iframe",
      "component": "iframe",
      "embedUrl": "https://www.youtube.com/embed/GLTTI1NFHus",
      "streamable": false,
      "downloadable": false,
    },
    "preview": {
      "thumbnail": {
        "url": "https://i.ytimg.com/vi/GLTTI1NFHus/hqdefault.jpg",
      },
    },
    "diagnostics": {
      "timings": {
        /* ... */
      },
    },
  },
  "enrichmentSources": {
    "semantic": "fresh",
    "mediaFormat": "fresh",
    "oembed": "fresh",
  },
  "projection": {
    "profile": "full",
    "hiddenFields": [],
  },
}

Media InspectorInfrastructure-Grade Media Intelligence