io.github.CDCStream/captapi

Official62 tools

by CDCStream · TypeScript

Social media data: 85 tools across 11 platforms (YouTube, TikTok, Instagram, X & more), one key.

Access social media data from 11 platforms (YouTube, TikTok, Instagram, X, etc) with 85 tools.

Captured live from the server via tools/list.

youtube_transcript

Extract the full timestamped transcript of a YouTube video. Costs ~2 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
Public YouTube video URL, e.g. https://youtube.com/watch?v=ID.
languagestring
Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.

youtube_summarize

AI summary (key points, topics, sentiment) of a YouTube video. Costs ~4 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
Public YouTube video URL, e.g. https://youtube.com/watch?v=ID.
languagestring
Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.

youtube_video_details

Metadata + engagement stats for a YouTube video. Costs ~1 credit; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
Public YouTube video URL, e.g. https://youtube.com/watch?v=ID.

youtube_comments

Comments on a YouTube video. Costs ~20 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
Public YouTube video URL, e.g. https://youtube.com/watch?v=ID.
limitinteger
Max items to return. Default 50, max 500. Billed per result.

youtube_channel_details

Channel info & subscriber/stats for a YouTube channel. Costs ~1 credit; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
YouTube channel URL, e.g. https://youtube.com/@handle or /channel/UC...

youtube_search

Search YouTube videos by keyword. Costs ~20 credits; cached results are free, failures are never charged.

Parameters (2)

qstringrequired
Search query or keywords (min 2 chars).
limitinteger
Max items to return. Default 20, max 200. Billed per result.

youtube_channel_videos

List a channel's uploaded videos. Costs ~20 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
YouTube channel URL, e.g. https://youtube.com/@handle or /channel/UC...
limitinteger
Max items to return. Default 20, max 200. Billed per result.

youtube_playlist_videos

List videos in a YouTube playlist. Costs ~50 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
YouTube playlist URL, e.g. https://youtube.com/playlist?list=ID.
limitinteger
Max items to return. Default 50, max 500. Billed per result.

youtube_video_download

Direct download URLs for a YouTube video. Costs ~3 credits; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
Public YouTube video URL, e.g. https://youtube.com/watch?v=ID.

youtube_shorts_transcript

Transcript of a YouTube Short. Costs ~2 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
Public YouTube Shorts URL, e.g. https://youtube.com/shorts/ID.
languagestring
Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.

youtube_shorts_summarize

AI summary of a YouTube Short. Costs ~4 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
Public YouTube Shorts URL, e.g. https://youtube.com/shorts/ID.
languagestring
Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.

youtube_shorts_details

Metadata + stats for a YouTube Short. Costs ~1 credit; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
Public YouTube Shorts URL, e.g. https://youtube.com/shorts/ID.

youtube_shorts_comments

Comments on a YouTube Short. Costs ~20 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
Public YouTube Shorts URL, e.g. https://youtube.com/shorts/ID.
limitinteger
Max items to return. Default 50, max 500. Billed per result.

youtube_channel_shorts

List a channel's Shorts. Costs ~20 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
YouTube channel URL, e.g. https://youtube.com/@handle or /channel/UC...
limitinteger
Max items to return. Default 20, max 200. Billed per result.

youtube_channel_streams

List a channel's live/past streams. Costs ~20 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
YouTube channel URL, e.g. https://youtube.com/@handle or /channel/UC...
limitinteger
Max items to return. Default 20, max 200. Billed per result.

youtube_hashtag_search

Search YouTube videos by hashtag. Costs ~20 credits; cached results are free, failures are never charged.

Parameters (2)

qstringrequired
Hashtag with or without the # (min 2 chars).
limitinteger
Max items to return. Default 20, max 200. Billed per result.

youtube_comment_replies

Replies to a specific YouTube comment. Costs ~20 credits; cached results are free, failures are never charged.

Parameters (3)

urlstringrequired
Public YouTube video URL, e.g. https://youtube.com/watch?v=ID.
comment_idstringrequired
ID of the parent comment to fetch replies for (from the comments endpoint).
limitinteger
Max items to return. Default 50, max 500. Billed per result.

youtube_channel_playlists

List a channel's playlists. Costs ~20 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
YouTube channel URL, e.g. https://youtube.com/@handle or /channel/UC...
limitinteger
Max items to return. Default 20, max 200. Billed per result.

youtube_community_posts

List a channel's community (posts) tab. Costs ~10 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
YouTube channel URL, e.g. https://youtube.com/@handle or /channel/UC...
limitinteger
Max items to return. Default 20, max 200. Billed per result.

tiktok_transcript

Transcript of a TikTok video (via captions). Costs ~2 credits; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
Public TikTok video URL, e.g. https://tiktok.com/@user/video/ID.

tiktok_summarize

AI summary of a TikTok video. Costs ~4 credits; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
Public TikTok video URL, e.g. https://tiktok.com/@user/video/ID.

tiktok_video_details

Metadata + stats for a TikTok video. Costs ~1 credit; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
Public TikTok video URL, e.g. https://tiktok.com/@user/video/ID.

tiktok_comments

Comments on a TikTok video. Costs ~10 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
Public TikTok video URL, e.g. https://tiktok.com/@user/video/ID.
limitinteger
Max items to return. Default 50, max 500. Billed per result.

tiktok_channel_details

Profile info & stats for a TikTok user. Costs ~1 credit; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
TikTok profile URL, e.g. https://tiktok.com/@username.

tiktok_search

Search TikTok videos by keyword/hashtag. Costs ~14 credits; cached results are free, failures are never charged.

Parameters (2)

qstringrequired
Search query or keywords (min 2 chars).
limitinteger
Max items to return. Default 20, max 200. Billed per result.

tiktok_video_download

No-watermark download URL for a TikTok video. Costs ~3 credits; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
Public TikTok video URL, e.g. https://tiktok.com/@user/video/ID.

tiktok_channel_posts

Latest posts from a TikTok profile. Costs ~14 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
TikTok profile URL, e.g. https://tiktok.com/@username.
limitinteger
Max items to return. Default 20, max 200. Billed per result.

tiktok_comment_replies

Replies to a specific TikTok comment. Costs ~50 credits; cached results are free, failures are never charged.

Parameters (3)

urlstringrequired
Public TikTok video URL, e.g. https://tiktok.com/@user/video/ID.
comment_idstringrequired
ID of the parent comment to fetch replies for (from the comments endpoint).
limitinteger
Max items to return. Default 50, max 500. Billed per result.

tiktok_user_followers

List a TikTok user's followers. Costs ~20 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
TikTok profile URL, e.g. https://tiktok.com/@username.
limitinteger
Max items to return. Default 50, max 500. Billed per result.

tiktok_user_followings

List who a TikTok user follows. Costs ~20 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
TikTok profile URL, e.g. https://tiktok.com/@username.
limitinteger
Max items to return. Default 50, max 500. Billed per result.

tiktok_music_posts

Posts using a specific TikTok sound/music. Costs ~32 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
TikTok music/sound URL, e.g. https://tiktok.com/music/name-ID.
limitinteger
Max items to return. Default 20, max 200. Billed per result.

tiktok_hashtag_search

Search TikTok videos by hashtag. Costs ~14 credits; cached results are free, failures are never charged.

Parameters (2)

qstringrequired
Hashtag with or without the # (min 2 chars).
limitinteger
Max items to return. Default 20, max 200. Billed per result.

tiktok_top_search

Top mixed TikTok results for a keyword. Costs ~14 credits; cached results are free, failures are never charged.

Parameters (2)

qstringrequired
Search query or keywords (min 2 chars).
limitinteger
Max items to return. Default 20, max 200. Billed per result.

tiktok_user_search

Search TikTok users/creators by keyword. Costs ~8 credits; cached results are free, failures are never charged.

Parameters (2)

qstringrequired
Search query or keywords (min 2 chars).
limitinteger
Max items to return. Default 20, max 100. Billed per result.

tiktok_song_details

Details of a TikTok sound/song. Costs ~2 credits; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
TikTok music/sound URL, e.g. https://tiktok.com/music/name-ID.

tiktok_trending_feed

TikTok trending (For You) videos by region. Costs ~14 credits; cached results are free, failures are never charged.

Parameters (2)

countrystring
Two-letter ISO country code, e.g. US, GB, TR. Default US.
limitinteger
Max items to return. Default 20, max 200. Billed per result.

tiktok_popular_hashtags

Trending TikTok hashtags for a topic/keyword. Costs ~14 credits; cached results are free, failures are never charged.

Parameters (2)

querystring
Topic or keyword to discover trending hashtags for. Default "trending".
limitinteger
Max items to return. Default 20, max 100. Billed per result.

instagram_transcript

Transcript of an Instagram Reel. Costs ~2 credits; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
Instagram Reel URL, e.g. https://instagram.com/reel/ID/.

instagram_summarize

AI summary of an Instagram Reel. Costs ~4 credits; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
Instagram Reel URL, e.g. https://instagram.com/reel/ID/.

instagram_details

Details for an Instagram post or reel. Costs ~1 credit; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
Instagram post or reel URL, e.g. https://instagram.com/reel/ID/.

instagram_comments

Comments on an Instagram post or reel. Costs ~45 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
Instagram post or reel URL, e.g. https://instagram.com/reel/ID/.
limitinteger
Max items to return. Default 50, max 500. Billed per result.

instagram_channel_details

Profile info & stats for an Instagram account. Costs ~1 credit; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
Instagram profile URL, e.g. https://instagram.com/username/.

instagram_channel_posts

Latest posts from an Instagram profile. Costs ~12 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
Instagram profile URL, e.g. https://instagram.com/username/.
limitinteger
Max items to return. Default 20, max 200. Billed per result.

instagram_channel_reels

Latest Reels from an Instagram profile. Costs ~12 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
Instagram profile URL, e.g. https://instagram.com/username/.
limitinteger
Max items to return. Default 20, max 200. Billed per result.

instagram_reels_search

Search Instagram Reels by hashtag/keyword. Costs ~12 credits; cached results are free, failures are never charged.

Parameters (2)

qstringrequired
Hashtag (without #) or keyword (min 2 chars).
limitinteger
Max items to return. Default 20, max 200. Billed per result.

instagram_video_download

Direct video URL for an Instagram Reel. Costs ~3 credits; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
Instagram Reel URL, e.g. https://instagram.com/reel/ID/.

instagram_tagged_posts

Posts an Instagram user is tagged in. Costs ~18 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
Instagram profile URL, e.g. https://instagram.com/username/.
limitinteger
Max items to return. Default 20, max 200. Billed per result.

instagram_music_posts

Posts/Reels using an Instagram audio. Costs ~18 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
Instagram audio/music page URL.
limitinteger
Max items to return. Default 20, max 200. Billed per result.

instagram_hashtag_search

Search Instagram posts by hashtag. Costs ~12 credits; cached results are free, failures are never charged.

Parameters (2)

qstringrequired
Hashtag without the # (min 2 chars).
limitinteger
Max items to return. Default 20, max 200. Billed per result.

instagram_profile_search

Search Instagram profiles by keyword. Costs ~12 credits; cached results are free, failures are never charged.

Parameters (2)

qstringrequired
Search query or keywords (min 2 chars).
limitinteger
Max items to return. Default 20, max 100. Billed per result.

instagram_story_highlights

List a profile's story highlight covers. Costs ~5 credits; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
Instagram profile URL, e.g. https://instagram.com/username/.

instagram_highlights_details

Items inside a profile's story highlights. Costs ~9 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
Instagram profile URL, e.g. https://instagram.com/username/.
limitinteger
Max highlights to expand. Default 10, max 50.

instagram_embed

Embed HTML for an Instagram post/reel. Costs ~1 credit; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
Instagram post or reel URL, e.g. https://instagram.com/reel/ID/.

facebook_details

Details for a Facebook video or post. Costs ~1 credit; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
Public Facebook video or post URL.

facebook_transcript

Transcript of a Facebook video. Costs ~2 credits; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
Public Facebook video or post URL.

facebook_summarize

AI summary of a Facebook video or post. Costs ~4 credits; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
Public Facebook video or post URL.

facebook_comments

Comments on a Facebook post. Costs ~30 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
Public Facebook video or post URL.
limitinteger
Max items to return. Default 50, max 500. Billed per result.

facebook_page_details

Info & stats for a Facebook page. Costs ~1 credit; cached results are free, failures are never charged.

Parameters (1)

urlstringrequired
Facebook page URL, e.g. https://facebook.com/PageName.

facebook_profile_posts

Latest posts from a Facebook profile/page. Costs ~12 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
Facebook profile or page URL.
limitinteger
Max items to return. Default 20, max 200. Billed per result.

facebook_profile_reels

Latest Reels from a Facebook profile/page. Costs ~36 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
Facebook profile or page URL.
limitinteger
Max items to return. Default 20, max 200. Billed per result.

facebook_group_posts

Posts from a public Facebook group. Costs ~12 credits; cached results are free, failures are never charged.

Parameters (2)

urlstringrequired
Public Facebook group URL, e.g. https://facebook.com/groups/ID.
limitinteger
Max items to return. Default 20, max 200. Billed per result.

facebook_comment_replies

Replies to a specific Facebook comment. Costs ~30 credits; cached results are free, failures are never charged.

Parameters (3)

urlstringrequired
Facebook post URL the comment belongs to.
comment_idstringrequired
ID of the parent comment to fetch replies for (from the comments endpoint).
limitinteger
Max items to return. Default 50, max 500. Billed per result.

README.md4 KBView on GitHub

Captapi

API-as-a-Service that extracts transcripts, AI summaries, comments, engagement metrics, and channel analytics from YouTube, TikTok, Instagram, and Facebook videos.

Architecture

Backend: FastAPI (Python 3.12) — Apify scraping + OpenAI summarization
Frontend: Next.js 15 + Tailwind + shadcn/ui — landing, dashboard, billing
DB / Auth: Supabase (Postgres + Auth + Storage)
Cache / Rate limit: Upstash Redis
Scraping: Apify Actors
AI: OpenAI (gpt-4o-mini + Whisper)
Billing: Stripe (subscriptions + top-up credits)

Quick Start

Prerequisites

Python 3.12+
Node.js 20+
Supabase project (free tier)
Apify account + API token
OpenAI API key
Stripe account (test mode)
Upstash Redis (free tier)

1. Supabase Setup

bash

# Install Supabase CLI
npm i -g supabase

# Login and link your project
supabase login
supabase link --project-ref YOUR_PROJECT_REF

# Push schema
supabase db push

2. Backend Setup

bash

cd backend
cp .env.example .env
# Fill in env vars

# Install dependencies (using uv)
pip install uv
uv pip install -e .

# Run dev server
uvicorn app.main:app --reload --port 8000

3. Frontend Setup

bash

cd frontend
cp .env.example .env.local
# Fill in env vars

npm install
npm run dev

Open http://localhost:3000.

Project Structure

code

socialkit-clone/
├── backend/                FastAPI service
│   ├── app/
│   │   ├── main.py         App entry
│   │   ├── core/           Config, auth, credits, security
│   │   ├── routers/        Endpoint handlers per platform
│   │   ├── services/       Apify, OpenAI, Supabase, Cache, Stripe
│   │   ├── schemas/        Pydantic models
│   │   └── utils/          Helpers
│   ├── pyproject.toml
│   └── Dockerfile
├── frontend/               Next.js 15 app
│   ├── app/                App Router
│   ├── components/         UI components
│   └── lib/                Supabase + API client
└── supabase/
    └── migrations/         SQL schema

API Endpoints

All endpoints require Authorization: Bearer capt_live_... header.

YouTube

GET /v1/youtube/transcript?url=...
GET /v1/youtube/summarize?url=...
GET /v1/youtube/video-details?url=...
GET /v1/youtube/comments?url=...&limit=...
GET /v1/youtube/channel-details?url=...
GET /v1/youtube/channel-videos?url=...&limit=...
GET /v1/youtube/playlist-videos?url=...&limit=...
GET /v1/youtube/search?q=...&limit=...
GET /v1/youtube/video-download?url=...

TikTok

GET /v1/tiktok/transcript|summarize|video-details|comments|channel-details|search|video-download

Instagram

GET /v1/instagram/transcript|summarize|details|comments|channel-details|channel-posts|channel-reels|reels-search|video-download

Facebook

GET /v1/facebook/transcript|summarize|details|comments|page-details

Video Files

POST /v1/video/transcript — multipart upload, Whisper transcription
POST /v1/video/summarize — transcription + AI summary

Account

GET /v1/account/usage — credit balance + recent requests
GET /v1/account/limits — plan + remaining quota

Pricing

Plan	Price/mo	Credits/mo	$/Credit
Free	$0	100 lifetime	—
Starter	$9	1,500	$0.006
Pro	$29	6,000	$0.0048
Business	$99	25,000	$0.0039
Top-up	$5	500	$0.01

License

MIT

Install

Configuration

Environment variables

CAPTAPI_API_KEYrequiredsecret

Your capt_live_... API key. Create one at https://captapi.com/dashboard/api-keys (100 free credits).

CAPTAPI_BASE_URL

Override the Captapi API base URL (default https://api.captapi.com).

claude_desktop_config.json

{
  "mcpServers": {
    "captapi": {
      "command": "npx",
      "args": [
        "-y",
        "@captapi/mcp@0.3.0"
      ],
      "env": {
        "CAPTAPI_API_KEY": "<YOUR_CAPTAPI_API_KEY>",
        "CAPTAPI_BASE_URL": "<YOUR_CAPTAPI_BASE_URL>"
      }
    }
  }
}