Skip to content

instatollm

Turn any Instagram Reel into a rich, LLM-ready structured description.

Instagram Reel URL  →  Download  →  Gemini AI  →  Structured JSON

instatollm extracts everything from a Reel in one API call: visual description, all on-screen text (OCR), speech transcript, music, hooks, key moments with timestamps, platform metadata, and more — in a consistent JSON format ready to feed into any LLM.

What you get

{
  "summary": "A chef demonstrates how to make pasta carbonara in under 60 seconds.",
  "visual": {
    "description": "Close-up shots of hands working in a professional kitchen...",
    "setting": "Indoor, professional kitchen",
    "subjects": ["chef", "pasta", "pan", "eggs"],
    "text_on_screen": ["CARBONARA", "3 ingredients only", "@chefmario"]
  },
  "audio": {
    "transcript": "Today I'll show you the only carbonara recipe you'll ever need...",
    "language": "en",
    "has_music": true,
    "music_description": "Upbeat Italian-style background music"
  },
  "content": {
    "topics": ["cooking", "Italian cuisine", "quick recipes"],
    "hooks": ["'The only carbonara recipe you'll ever need'"],
    "tone": "educational",
    "call_to_action": "Follow for more recipes",
    "key_moments": [
      { "timestamp_s": 0, "description": "Hook: chef introduces the recipe" },
      { "timestamp_s": 15, "description": "Adding guanciale to pan" },
      { "timestamp_s": 45, "description": "Final plating and reveal" }
    ]
  },
  "metadata": {
    "estimated_duration_s": 58,
    "format": "tutorial",
    "target_audience": "home cooks, food enthusiasts",
    "sentiment": "positive"
  },
  "platform_meta": {
    "title": "The only carbonara recipe",
    "uploader": "@chefmario",
    "like_count": 142000,
    "view_count": 2100000,
    "upload_date": "20250110",
    "tags": ["pasta", "cooking", "italian"]
  }
}

Send any Instagram Reel URL to the bot and receive a formatted analysis:

📹 tutorial · positive

A chef demonstrates pasta carbonara in under 60 seconds.

👤 @chefmario · 👁 2.1M · ❤️ 142K

🎬 Визуал:
Close-up shots of hands working in a professional kitchen...

🔤 Текст на экране:
CARBONARA · 3 ingredients only · @chefmario

🗣 Today I'll show you the only carbonara recipe...

🪝 Hook: 'The only carbonara recipe you'll ever need'

#cooking #Italian_cuisine #quick_recipes

⏱ 58с · 🌐 en · 👥 home cooks

Quick start

1. Get an API token from the dashboard.

2. Submit a Reel:

curl -X POST https://api.instatollm.com/api/v1/reels/analyze \
  -H "Authorization: Bearer ist_your_token" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.instagram.com/reel/DYa0IXPgnP5/"}'

{ "id": 42, "status": "pending" }

3. Poll for result:

curl https://api.instatollm.com/api/v1/reels/42 \
  -H "Authorization: Bearer ist_your_token"

When status is done, the result field contains the full analysis.

→ Full quickstart guide

Use cases

Use case How
Feed reels to ChatGPT/Claude Submit URL → get JSON → pass to LLM
Content analysis pipeline Batch-process reels, store JSON in DB
Competitor monitoring Analyze competitor reels automatically
OCR menus/prices visual.text_on_screen captures all on-screen text
Transcript extraction audio.transcript gives verbatim speech
Hook analysis content.hooks + content.key_moments

Processing time

Reel length Typical time
15–30s 20–40 seconds
30–60s 40–70 seconds
60–90s 60–90 seconds

Processing is async — submit and poll.