---
name: api.entit.ai
description: api.entit.ai accepts short-form social video URLs (TikTok, Instagram Reels, YouTube Shorts) and runs asynchronous transcription and visual analysis jobs on them. Callers submit a URL, receive a jobId and pollUrl, then poll for results containing transcription and visual descriptions.
host: api.entit.ai
---

# api.entit.ai

Entit is a single-purpose API for extracting text transcription and visual analysis from short-form social video content. It targets agents and applications that need to understand what is said and shown in TikTok, Instagram Reel, or YouTube Shorts videos, and that can accommodate an asynchronous polling pattern rather than requiring an immediate synchronous response.

## When to use this host

Use this host when an agent needs to extract transcription or visual descriptions from TikTok, Instagram Reel, or YouTube Shorts URLs and can handle asynchronous polling for results. Do not use it for standard long-form YouTube videos, non-video TikTok content such as photo slideshows, or any platform outside the three supported ones. Do not use it when a synchronous, immediate result is required — the API only returns a pollUrl and the caller must check back for completion. For general video transcription of long-form or platform-agnostic content, a different transcription service (e.g. OpenAI Whisper-based APIs or dedicated transcription platforms) would be more appropriate.

## Capabilities

### Video Analysis Job Submission

Submits a short-form social video URL for transcription and visual analysis, returning a jobId and pollUrl that the caller uses to retrieve results asynchronously.

- **`submit-video-analysis-job`** — Submits a TikTok, Instagram Reel, or YouTube Shorts URL for transcription and visual analysis, returning a jobId and pollUrl for async result retrieval.

## Skill reference

### `submit-video-analysis-job`

**Entit Video Analysis Job Submission** — Submits a TikTok, Instagram Reel, or YouTube Shorts URL for transcription and visual analysis, returning a jobId and pollUrl for async result retrieval.

*Use when:* Use when an agent needs to extract transcription or visual description from a short-form social video (TikTok, Instagram Reel, YouTube Shorts) and can poll for results asynchronously using the returned pollUrl.

*Not for:* Do not use for long-form YouTube videos, non-video content (e.g. TikTok photo slideshows), or platforms other than TikTok, Instagram, and YouTube Shorts. Not suitable when a synchronous/immediate result is required without polling.

**Inputs:**

- `url` (string, required) — Full URL of the TikTok, Instagram Reel, or YouTube Shorts video to analyze. Can also be passed as a query parameter instead of in the JSON body.

**Returns:** Returns a 202 with jobId, videoId, status='pending', and a pollUrl path to retrieve the completed transcription and visual analysis once processing finishes.

**Example:** `{"url": "https://www.tiktok.com/@natgeo/video/7352400000000000001"}`

---