Video Summaries

Overview

socialkit-api

summary

mainTopics

keyPoints

tone

targetAudience

quotes

timeline

Endpoint by Platform

/youtube/summarize

youtube_summarize

/tiktok/summarize

tiktok_summarize

/instagram/summarize

instagram_summarize

/facebook/summarize

facebook_summarize

/video/summarize

video_summarize

video-transcripts

Workflow

1. Identify the platform and pick the matching summarize endpoint.
2. Call it with the full public

   url

   .
3. For more than a few same-platform URLs, use the bulk route.
4. Shape the output to the user's ask. If they want a one-line TL;DR, give the

   summary

   . If they want to decide whether to watch, lead with

   mainTopics

   and

   keyPoints

   .

Single Summary

export SOCIALKIT_API_KEY="YOUR_SOCIALKIT_ACCESS_KEY"

curl -s "https://api.socialkit.dev/youtube/summarize?url=https://youtube.com/watch?v=dQw4w9WgXcQ" \
  -H "x-access-key: $SOCIALKIT_API_KEY"

Bulk Summaries

curl -s -X POST "https://api.socialkit.dev/tiktok/summarize/bulk" \
  -H "x-access-key: $SOCIALKIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "urls": [
    "https://www.tiktok.com/@user/video/ID1",
    "https://www.tiktok.com/@user/video/ID2"
  ] }'

Common Pitfalls

• TikTok summarySource=visual uses images and description only after confirmed caption absence. Label this source and never invent spoken quotes; operational extraction failures do not justify generating a fallback summary.
• Do not summarize an X or LinkedIn video with a summarize endpoint. Transcribe first, then summarize.
• When comparing several videos, run them in one bulk call rather than many single calls.

Output Standards

• Match the depth the user asked for. Do not return all six fields when they wanted a sentence.
• When summarizing many videos, add a short cross-video takeaway, not just a stack of separate summaries.

socialkit-api