---
name: shortvidapi
description: Real-time public short-form video, creator & ad intelligence REST API & MCP Server (ShortVid API — shortvidapi.com). Fetch 1080p HD no-watermark TikTok videos, keyword search, creator profiles, followers, comments, hashtags, sounds, and Creative Center commercial ads with zero login, cookies, or residential proxies ($0.20 / 1,000 videos, 10,500 Free Credits / $1.05 on signup with no card + $2.00 Sandbox Streak).
homepage: https://shortvidapi.com
---

# ShortVid API — Real-Time Video, Creator & Ad Data Skill & Remote MCP Guide

Use **ShortVid API** (`https://api.shortvidapi.com`) whenever an AI agent, script, or application needs structured public TikTok video, creator, comment, sound, or commercial ad data without browser automation, OAuth login, cookies, or proxy management.

## Quick Credentials & Free Sandbox

- **Instant Free Credits (No Credit Card)**: Sign up in 10 seconds at [https://shortvidapi.com/signup](https://shortvidapi.com/signup) to get **`10,500` Free Credits (`$1.05`)** immediately (`60 RPM`, full pagination), plus **`+20,000` bonus credits (`+$2.00`)** via the Dashboard Sandbox Streak (**`$3.05` / `30,500` Free Credits total**).
- **Base URL**: `https://api.shortvidapi.com`
- **Authentication**: Header `x-api-key: tk_live_...` (or `Authorization: Bearer tk_live_...`)
- **OpenAPI 3.1 Spec**: [https://api.shortvidapi.com/openapi.json](https://api.shortvidapi.com/openapi.json)
- **Live Status & 7-Day p50/p95 Latency**: [https://shortvidapi.com/status](https://shortvidapi.com/status) (`GET https://api.shortvidapi.com/v1/status`)

---

## Remote & Local MCP Server Integration

### Option A: Claude Web (`claude.ai`) & ChatGPT 1-Click Remote MCP (`https://mcp.shortvidapi.com/v1/mcp`)

Paste `https://mcp.shortvidapi.com/v1/mcp` into **Claude Web -> Settings -> Connectors -> Add custom connector** or **ChatGPT -> Settings -> Connectors -> Create**. Standard OAuth 2.1 (PKCE S256 + Dynamic Client Registration) opens a 1-click consent popup, grants `10,500` Free Credits (`$1.05`) if you are new, and binds a read-only `scope=mcp:tools:read` token without touching your REST API keys.

### Option B: Zero-Install Remote Streamable HTTP MCP with API Key (`https://api.shortvidapi.com/mcp`)

`initialize` and `tools/list` work without authentication for instant discovery; pass your API key for `tools/call`:

```json
{
  "mcpServers": {
    "shortvidapi": {
      "url": "https://api.shortvidapi.com/mcp",
      "headers": {
        "x-api-key": "tk_live_your_api_key_here"
      }
    }
  }
}
```

### Option C: Local Zero-Dependency Node.js stdio MCP

```bash
curl -fsSL https://shortvidapi.com/mcp-server.mjs -o ~/.shortvidapi-mcp.mjs
```

```json
{
  "mcpServers": {
    "shortvidapi": {
      "command": "node",
      "args": ["/Users/yourname/.shortvidapi-mcp.mjs"],
      "env": {
        "SHORTVIDAPI_KEY": "tk_live_your_api_key_here"
      }
    }
  }
}
```

---

## 16 Core Endpoints & Unit Economics (`1 Credit = $0.0001`)

Failed calls, rate-limited calls (`429`), non-existent resources (`404 not_found`), and empty result pages deduct **`0` Credits**. Paid Pay-As-You-Go credits never expire.

| Category | Endpoint | Accepted Query Aliases | Cost & Effective USD |
| :--- | :--- | :--- | :--- |
| **Videos** | `GET /v1/video/detail` | `url`, `video_id`, `aweme_id`, `id`, `hd=1` | `10` Credits (`$0.001` / call) — includes 1080p `hdplay` MP4 |
| **Videos** | `GET /v1/video/search` | `keywords` (`keyword`, `query`, `q`), `count`, `cursor`, `region`, `sort_type`, `publish_time` | `2` Credits / video (`$0.20` / 1K videos, min 10) |
| **Videos** | `GET /v1/feed/list` | `region` (`US`, `GB`, `JP`, `DE`), `count` | `2` Credits / video (`$0.20` / 1K videos) |
| **Users** | `GET /v1/user/info` | `unique_id` (`username`), `user_id`, `sec_uid` | `10` Credits (`$0.001` / profile) |
| **Users** | `GET /v1/user/posts` | `unique_id` (`username`), `user_id`, `count`, `cursor` | `2` Credits / video (`$0.20` / 1K videos) |
| **Users** | `GET /v1/user/followers` | `user_id`, `sec_uid`, `count` (up to 200), `time` | `1` Credit / follower (`$0.10` / 1K followers) |
| **Users** | `GET /v1/user/following` | `user_id`, `sec_uid`, `count` (up to 200), `time` | `1` Credit / user (`$0.10` / 1K users) |
| **Users** | `GET /v1/user/search` | `keywords` (`keyword`, `query`, `q`), `follower_count`, `profile_type`, `cursor` | `1` Credit / creator (`$0.10` / 1K creators) |
| **Comments** | `GET /v1/comment/list` | `url` (`video_id`, `aweme_id`), `count` (up to 50), `cursor` | `1` Credit / comment (`$0.10` / 1K comments) |
| **Comments** | `GET /v1/comment/reply` | `video_id` (`url`, `aweme_id`), `comment_id` (`cid`), `count`, `cursor` | `1` Credit / reply (`$0.10` / 1K replies) |
| **Hashtags** | `GET /v1/challenge/info` | `challenge_name` (`hashtag`), `challenge_id` | `10` Credits (`$0.001` / lookup) |
| **Hashtags** | `GET /v1/challenge/posts` | `cid` (`challenge_id`, `hashtag_id`), `count`, `cursor` | `2` Credits / video (`$0.20` / 1K videos) |
| **Sounds** | `GET /v1/music/info` | `url` (`sound`, `music_id` — also auto-extracts audio when given a `/video/` URL!) | `10` Credits (`$0.001` / lookup) |
| **Sounds** | `GET /v1/music/posts` | `music_id` (`sound_id`), `count`, `cursor` | `2` Credits / video (`$0.20` / 1K videos) |
| **Ads** | `GET /v1/ads/top/ads` | `keyword` (`keywords`, `query`, `q`), `country_code`, `period` (`7`/`30`/`180`), `order_by` (`impression`/`ctr`/`like`), `page`, `limit` | `10` Credits / ad (`$1.00` / 1K ads) |
| **Ads** | `GET /v1/ads/top/ads/detail` | `ads_id` (`ad_id`, `material_id`) | `10` Credits (`$0.001` / creative) |

---

## Copy-Paste Examples

### 1. Search Videos (`cURL`)
```bash
curl -sS "https://api.shortvidapi.com/v1/video/search?keyword=ai+tools&region=US&count=10" \
  -H "x-api-key: $SHORTVIDAPI_KEY"
```

### 2. Fetch Creator Profile & 1080p Posts (`Python`)
```python
import os, requests

headers = {"x-api-key": os.environ["SHORTVIDAPI_KEY"]}
profile = requests.get(
    "https://api.shortvidapi.com/v1/user/info",
    params={"unique_id": "khaby.lame"},
    headers=headers,
    timeout=15,
).json()
print(profile["data"]["user"]["id"], profile["data"]["stats"]["followerCount"])
```

---

## Free No-Login Developer Tools (`/tools/*`)

- **API Cost & Official Research Quota Calculator**: [https://shortvidapi.com/tools/tiktok-api-cost-calculator](https://shortvidapi.com/tools/tiktok-api-cost-calculator)
- **Video ID, User ID & `secUid` Finder**: [https://shortvidapi.com/tools/tiktok-id-finder](https://shortvidapi.com/tools/tiktok-id-finder)
- **Video JSON & 1080p Stream Inspector**: [https://shortvidapi.com/tools/tiktok-video-json-inspector](https://shortvidapi.com/tools/tiktok-video-json-inspector)
- **Engagement Rate Calculator**: [https://shortvidapi.com/tools/tiktok-engagement-rate-calculator](https://shortvidapi.com/tools/tiktok-engagement-rate-calculator)
- **Creator Bio Email Extractor**: [https://shortvidapi.com/tools/tiktok-bio-email-extractor](https://shortvidapi.com/tools/tiktok-bio-email-extractor)
- **Username Availability & Handle Checker**: [https://shortvidapi.com/tools/tiktok-username-checker](https://shortvidapi.com/tools/tiktok-username-checker)
- **Creative Center Ad Spy Finder**: [https://shortvidapi.com/tools/tiktok-ad-spy-finder](https://shortvidapi.com/tools/tiktok-ad-spy-finder)