Integrations

Overview

Captapi plugs straight into your AI tooling. The official @captapi/mcp server exposes all 174 endpoints as typed tools over the Model Context Protocol, so Claude, Cursor, VS Code, and any MCP-compatible agent can pull transcripts, comments, profiles, search results, and more — billed to your account, with cached results free.

Prefer a one-click setup? Open Agent Integrations in your dashboard for install buttons with your key pre-filled. Agents can read the machine-readable manifest at /mcp.json.

Not using MCP? The same 174 endpoints are also available as typed TypeScript & Python SDKs, a CLI, an n8n community node, a Make.com app, and an Apify Actor — or call the REST API directly.

MCP Server

There are two ways to connect — both expose the same 174 tools. Pick Hosted for the fastest setup (no install), or Local if you prefer running the package on your machine. Replace the key with your own from API Keys, then restart the client.

Option A — Hosted (no install, just a URL)

Connect over HTTP to https://api.captapi.com/mcp. Nothing to install — your key is passed as an Authorization header (or x-api-key). Ideal for agents that can't run local processes.

// ~/.cursor/mcp.json  (or .cursor/mcp.json per project)
{
  "mcpServers": {
    "captapi": {
      "url": "https://api.captapi.com/mcp",
      "headers": { "Authorization": "Bearer capt_live_xxxxxxxxxxxxxxxx" }
    }
  }
}

Option B — Local (npx / stdio)

Run the official @captapi/mcp package via npx. It talks to your client over stdio and reads your key from the CAPTAPI_API_KEY environment variable.

// ~/.cursor/mcp.json  (or .cursor/mcp.json per project)
{
  "mcpServers": {
    "captapi": {
      "command": "npx",
      "args": ["-y", "@captapi/mcp"],
      "env": { "CAPTAPI_API_KEY": "capt_live_xxxxxxxxxxxxxxxx" }
    }
  }
}

Configuration (local mode)

Tools & Parameters

Each endpoint is a tool named platform_action. Required parameters are marked *. The agent fills these in for you.

Typed SDKs (TypeScript & Python)

Writing code? The official SDKs cover every endpoint with typed, namespaced methods — great autocomplete for humans and AI coding agents — and errors always throw, never silently return empty data. TypeScript: @captapi/sdk (zero dependencies, Node 18+/Deno/Bun/edge). Python: pip install captapi (sync + async clients on httpx).

// TypeScript — npm install @captapi/sdk
import { Captapi } from "@captapi/sdk";
const client = new Captapi({ apiKey: "capt_live_..." });
const res = await client.youtube.transcript({ url: "https://youtube.com/watch?v=..." });

# Python — pip install captapi
from captapi import Captapi
client = Captapi(api_key="capt_live_...")
res = client.youtube.transcript(url="https://youtube.com/watch?v=...")

Platform features (batch, monitors, history, status)

Beyond single calls, the API ships building blocks competitors make you assemble yourself:

• Batch — POST /v1/batch runs up to 20 endpoint calls concurrently in one request, with per-item status and billing (cached items stay free).
• Monitors + webhooks — POST /v1/monitors watches any list endpoint (subreddit posts, channel videos, ad-library searches…) on your schedule and POSTs only new items to your webhook, HMAC-signed. Test deliveries with POST /v1/monitors/{id}/test.
• Metric history — GET /v1/history returns follower/view/like time series that accumulate automatically whenever tracked profile or post endpoints are fetched fresh.
• Live status — GET /v1/status (no auth) exposes per-platform success rates from real traffic; the human view lives at /status.

Command-line (CLI)

Prefer the terminal, a shell script, or CI? The official @captapi/cli package exposes all 174 endpoints as commands. Authenticate once with captapi login (or set CAPTAPI_API_KEY), then call any endpoint — each one is a subcommand, parameters are flags, and responses print as JSON to stdout so they pipe cleanly into jq and scripts. It can even wire the MCP server into your agent with captapi agent add.

npm install -g @captapi/cli      # or just use: npx @captapi/cli <command>

captapi login                    # paste your capt_live_… key (saved to ~/.captapi/config.json)
captapi whoami                   # confirm the active key
captapi balance                  # remaining credits + recent requests

Workflow automation (n8n)

Building no-code/low-code automations? The official n8n-nodes-captapi community node brings all 174 endpoints into n8n. Install it from Settings → Community Nodes, add a Captapi API credential with your capt_live_… key, then drop the Captapi node into any workflow — pick a platform and operation, and pipe the structured JSON into your other nodes.

# In n8n: Settings → Community Nodes → Install
n8n-nodes-captapi

# Self-hosted (npm), then restart n8n:
npm install n8n-nodes-captapi

No-code scenarios (Make.com)

Prefer Make.com (Integromat)? The Captapi custom app exposes all 174 endpoints as action modules grouped by platform. Add a Captapi API Key connection with your capt_live_… key, then drop the module you need into a scenario — it returns the same structured JSON as the REST API for downstream modules.

// Create a "Captapi API Key" connection once:
//   API Key = capt_live_xxxxxxxxxxxxxxxx   (from /dashboard/api-keys)
// Make verifies the key against /v1/account/limits.

Apify Actor (bring your own key)

Running on Apify? The Captapi Actor is a thin bring-your-own-key wrapper around the REST API — it does not scrape. Set your capt_live_… key, pick an operation, and the Actor returns one dataset item with the same structured JSON. Credits are billed to your own Captapi account, so it stays free to run. Its input and output fields are fully documented, so AI agents on Apify's MCP server can discover and run it too.

{
  "apiKey": "capt_live_xxxxxxxxxxxxxxxx",
  "operation": "youtube_transcript",
  "url": "https://youtube.com/watch?v=dQw4w9WgXcQ"
}