Analyse a video

{
  "run": {
    "id": "run_8f2c1ad04b",
    "kind": "video_intelligence",
    "status": "completed",
    "created_at": "2026-09-08T09:14:02.418Z",
    "completed_at": "2026-09-08T09:14:04.930Z",
    "charge_credits": 23,
    "list_price_credits": 23,
    "cached": false
  },
  "result": {
    "platform": "tiktok",
    "id": "7300000000000000000",
    "url": "https://www.tiktok.com/@someone/video/7300000000000000000",
    "description": "3 minutes at 4°C every morning for 30 days. Here is what actually changed. #coldplunge #recovery",
    "posted_at": "2026-09-05T06:32:11.000Z",
    "duration_seconds": 41,
    "thumbnail_url": "https://p16-sign.tiktokcdn.com/obj/tos-cover-7300000000000000000.jpeg",
    "hashtags": [
      "coldplunge",
      "recovery",
      "morningroutine"
    ],
    "sound": {
      "id": "7180000000000000000",
      "title": "original sound - someone"
    },
    "creator": {
      "id": "cre_9d4b2a7f1c",
      "handle": "someone",
      "name": "Someone",
      "follower_count": 184300
    },
    "snapshot": {
      "at": "2026-09-08T09:14:04.219Z",
      "views": 1284000,
      "likes": 143200,
      "comments": 2810,
      "shares": 9040,
      "saves": 21600
    },
    "scores": {
      "outlier": 4.21,
      "outlier_p90": 1.6,
      "percentile": 95,
      "velocity": {
        "views_per_hour": 6698.6,
        "window": "snapshot"
      },
      "reason": null,
      "baseline": {
        "median_views": 305000,
        "p90_views": 802000,
        "engagement_rate": 0.1342,
        "posts_per_week": 4.1,
        "sample": 20,
        "confidence": "high",
        "source": "videos",
        "computed_at": "2026-09-08T09:14:03.902Z",
        "stale": false
      }
    },
    "intelligence": {
      "version": 1,
      "model": "gemini-2.5-flash",
      "computed_at": "2026-09-08T09:14:04.612Z",
      "source": "speech",
      "content": {
        "summary": "A 30-day cold plunge diary that leads with the measurable change and keeps the discomfort visible rather than heroic.",
        "niche": "HEALTH_AND_FITNESS",
        "languages": [
          "en"
        ],
        "content_styles": [
          "TALKING_HEAD",
          "PROGRESS_DIARY"
        ],
        "keywords": [
          {
            "keyword": "cold plunge",
            "category": "ACTION",
            "sentiment": 0.4
          },
          {
            "keyword": "recovery",
            "category": "TOPIC",
            "sentiment": 0.6
          }
        ],
        "transcript": "Day one I lasted eleven seconds. Day thirty I stopped noticing the cold at all, and that is the part nobody warns you about..."
      },
      "hook": {
        "opening_line": "Day one I lasted eleven seconds.",
        "type": "SPECIFIC_DETAIL",
        "visual_hook": "Timer overlay counting up on a shot of the plunge tub at dawn",
        "rationale": "A concrete, unimpressive number invites the viewer to stay for the number it becomes."
      },
      "persuasion": {
        "call_to_action": {
          "type": "FOLLOW",
          "text": "Following along? Day 60 starts Monday."
        },
        "sponsored": false,
        "sponsorship_signals": [],
        "brands_and_products": [
          {
            "name": "Plunge",
            "kind": "PRODUCT",
            "prominence": "INCIDENTAL"
          }
        ],
        "trend_references": [
          {
            "name": "30-day challenge",
            "kind": "FORMAT"
          }
        ]
      },
      "tone": {
        "sentiment_label": "Positive",
        "sentiment_score": 0.42,
        "primary_emotion": "Determination",
        "emotion_intensity": 0.6,
        "emotion_rationale": "The delivery stays level through visible discomfort, which reads as resolve rather than excitement.",
        "speaking_style": "CONVERSATIONAL",
        "speaking_style_notes": "Unhurried voiceover over hard cuts between mornings, with no music bed under the first ten seconds."
      },
      "visual": {
        "format": "VLOG",
        "setting": "OUTDOOR_HOME",
        "face_visibility": "CREATOR_ON_CAMERA",
        "on_screen_text": [
          "DAY 1",
          "DAY 30",
          "11s → 3:00"
        ],
        "has_on_screen_captions": true,
        "camera_notes": "Fixed tripod at tub height, one handheld reaction shot per morning, cut roughly every two seconds.",
        "lighting_notes": "Natural dawn light, cool and slightly underexposed throughout.",
        "elements": [
          {
            "type": "OBJECT",
            "name": "ice bath",
            "confidence": 0.97
          }
        ]
      },
      "safety": {
        "brand_safety_tier": "SAFE",
        "reasons": [],
        "notes": null
      }
    }
  }
}

{
  "run": {
    "id": "run_8f2c1ad04b",
    "kind": "video_intelligence",
    "status": "running",
    "created_at": "2026-09-08T09:14:02.418Z",
    "completed_at": null,
    "charge_credits": 0,
    "list_price_credits": 0,
    "cached": false
  }
}

{
  "type": "https://www.shortsintel.com/docs/reference/errors/invalid_request",
  "title": "Invalid request",
  "status": 400,
  "code": "invalid_request",
  "detail": "`estimate` must be `true` or `false`."
}

{
  "type": "https://www.shortsintel.com/docs/reference/errors/invalid_key",
  "title": "Invalid key",
  "status": 401,
  "code": "invalid_key",
  "detail": "That API key does not exist. Keys look like `sk_live_...` and are created in the console."
}

{
  "type": "https://www.shortsintel.com/docs/reference/errors/insufficient_balance",
  "title": "Insufficient balance",
  "status": 402,
  "code": "insufficient_balance",
  "detail": "Your balance does not cover this operation. Top up in the console.",
  "balance_credits": 0,
  "required_credits": 23
}

{
  "type": "https://www.shortsintel.com/docs/reference/errors/idempotency_conflict",
  "title": "Idempotency conflict",
  "status": 409,
  "code": "idempotency_conflict",
  "detail": "This Idempotency-Key was used with a different payload.",
  "run_id": "run_8f2c1ad04b"
}

{
  "type": "https://www.shortsintel.com/docs/reference/errors/rate_limit_exceeded",
  "title": "Rate limit exceeded",
  "status": 429,
  "code": "rate_limit_exceeded",
  "detail": "60 requests per minute per key. Retry after the number of seconds in `Retry-After`.",
  "limit": 60
}

{
  "type": "https://www.shortsintel.com/docs/reference/errors/vendor_error",
  "title": "Vendor error",
  "status": 502,
  "code": "vendor_error",
  "detail": "The upstream data provider could not be reached.",
  "run": {
    "id": "run_8f2c1ad04b",
    "kind": "video_intelligence",
    "status": "failed",
    "created_at": "2026-09-08T09:14:02.418Z",
    "completed_at": "2026-09-08T09:14:04.930Z",
    "charge_credits": 0,
    "list_price_credits": 0,
    "cached": false
  }
}

{
  "type": "https://www.shortsintel.com/docs/reference/errors/source_unavailable",
  "title": "Source unavailable",
  "status": 503,
  "code": "source_unavailable",
  "detail": "The tiktok/video source is unavailable right now.",
  "endpoints": [
    "tiktok/video"
  ],
  "run": {
    "id": "run_8f2c1ad04b",
    "kind": "video_intelligence",
    "status": "failed",
    "created_at": "2026-09-08T09:14:02.418Z",
    "completed_at": "2026-09-08T09:14:04.930Z",
    "charge_credits": 0,
    "list_price_credits": 0,
    "cached": false
  }
}