# entit.ai Video Analysis API

> entit.ai Video Analysis API is a paid API for AI agents from api.entit.ai, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-12).

Analyzes TikTok, Instagram Reel, or YouTube Shorts videos to extract transcripts, scenes, and visual summaries, with optional domain-specific workflow templates

## Facts

- Endpoint: POST https://api.entit.ai/v1/jobs?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/entit-ai-video-analysis-api-80bf0e28
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_66yzu1NzZnAvmUWKDBU3D

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability entit-ai-video-analysis-api-80bf0e28 -d '<json body>'
```

Example prompt: Can you analyze this TikTok video for me — https://www.tiktok.com/@mealsandmunchies/video/7626340146480155917 — and pull out the full transcript, scenes, and a visual summary of what's happening?

## When to prefer this

Choose this endpoint when you need structured extraction from short-form social video content (TikTok, Instagram Reels, YouTube Shorts) and want domain-specific output templates like brand safety scoring, recipe extraction, product tagging, or educational flashcards. It is the go-to option for agents working in social media analytics, e-commerce enrichment, content moderation, or creator tooling pipelines where videos need to be semantically understood. Prefer it over generic video transcription services when you need scene-level analysis, on-screen text detection, and author metadata in a single call, or when you want opinionated workflow outputs for specific verticals.

## Known failure modes

- Unsupported video platform URL returns an error (only TikTok, Instagram Reels, YouTube Shorts are accepted)
- Private or deleted video URL causes job failure
- Polling URL must be checked repeatedly until job completes — premature reads return in-progress status
- Switching format on a cached video invalidates cache and triggers a new paid job
- Malformed URL input returns validation error
- Video too long or unavailable in the region may cause processing failure

## How this service works

Analyse a TikTok, Instagram Reel, or YouTube Shorts video. Omit format for full VideoAnalysis (transcript, scenes, visual summary). Optional format selects a workflow template (24 formats: brand safety, creator brief, recipe, tutorials, e-commerce, health, education, news, music, sports, travel — see entit.ai/docs/api#workflow-formats). Caches are per format — switching format requires a new paid job. POST a video URL; poll the returned URL (free) until ready.

## Output

Returns a job ID and a polling URL. Once the job completes, the result includes the video URL, platform, language, author handle, on-screen text, full transcription, a list of timestamped scene descriptions, and a visual description. If a workflow format was specified, the result object conforms to that workflow's schema (e.g. recipe steps, product tags, health claims list). Status field indicates success or failure.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "format": "uri",
   "description": "TikTok, Instagram Reel, or YouTube Shorts URL."
  },
  "format": {
   "enum": [
    "content-screening",
    "creator-brief",
    "recipe",
    "tutorial-guide",
    "quote-highlights",
    "product-tagging",
    "shop-the-look",
    "review-summary",
    "workout-plan",
    "health-claims",
    "flashcards",
    "curriculum-tags",
    "language-learning",
    "ugc-verification",
    "breaking-news-signal",
    "eyewitness-timeline",
    "song-context",
    "lyric-hook",
    "sound-trend",
    "technique-analysis",
    "highlight-reel",
    "scouting-report",
    "destination-guide",
    "restaurant-discovery"
   ],
   "type": "string",
   "description": "Optional workflow output template. Omit for default VideoAnalysis (transcript, scenes, visual summary). When set, responses echo this field and `result` uses the matching workflow shape. See https://entit.ai/docs/api#workflow-formats"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "jobId": "e0b8ca11-e3f4-4e3d-a502-8acac11c9254",
  "result": {
   "url": "https://www.tiktok.com/@mealsandmunchies/video/7626340146480155917",
   "scenes": [
    {
     "timestamp": "0:00",
     "description": "A blonde woman in a pink striped shirt stands in her kitchen, holding and opening a tube of canned cinnamon rolls while speaking to the camera."
    },
    {
     "timestamp": "0:45",
     "description": "A close-up shot of the finished, baked dessert in the green dish as she pours white icing from a small plastic container over it."
    }
   ],
   "language": "en",
   "platform": "tiktok",
   "processedAt": "2026-05-21T22:12:38.086265Z",
   "authorHandle": "@mealsandmunchies",
   "onScreenText": "the end shows how good this comes out",
   "transcription": "I wasn't gonna film this because I've shared this two ingredient dessert before already, but every time I do share it, it gets millions of views, so I decided to share it again. So grab some cinnamon rolls, cut them into pieces like this...",
   "visualDescription": "In a brightly lit kitchen, a woman demonstrates a simple two-ingredient dessert recipe. She combines cut-up canned cinnamon rolls with apple pie filling in a baking dish, then bakes and tops it with icing."
  },
  "status": "success",
  "videoId": "7626340146480155917"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/entit-ai-video-analysis-api-80bf0e28/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.entit.ai](https://www.zero.xyz/host/api.entit.ai/llms.txt)