# ShortVid API — Complete LLM & AI Agent Technical Reference (llms-full.txt)

> High-speed, no-watermark Data & Creative Center Commercial Ads REST API for TikTok.
> Base URL: `https://api.shortvidapi.com` | Main Website: `https://shortvidapi.com`
> OpenAPI 3.0 Spec: `https://shortvidapi.com/openapi.json` | Compact Summary: `https://shortvidapi.com/llms.txt`

## 1. Authentication & Core Architecture

- **Base URL**: `https://api.shortvidapi.com`
- **Authentication Header**: Pass either `x-api-key: tk_your_api_key` OR `Authorization: Bearer tk_your_api_key` on every request.
- **No OAuth / No Cookies / No Proxies**: Works directly from AWS, GCP, Azure, Hetzner, Vercel, and Cloudflare Workers without platform developer review or user login.
- **Free Trial**: Every new account receives **10,500 Free Credits ($1.05)** and an active API key immediately upon sign-up at `https://shortvidapi.com/signup` (no credit card or approval needed), plus up to **+20,000 bonus credits ($2.00)** via Developer Sandbox Streak.
- **Zero Charge on Errors & Empty Pages**: Any failed lookup, 404 resource, 5xx error, timeout, or 0-item empty response costs **0 Credits**.
- **Core Pillar Pages**: `https://shortvidapi.com/tiktok-api`, `https://shortvidapi.com/tiktok-scraper`, `https://shortvidapi.com/from-apify` (Apify Actor -> synchronous REST migration), `https://shortvidapi.com/status` (live p50/p95 telemetry), `https://shortvidapi.com/mcp`, `https://shortvidapi.com/tools/tiktok-api-cost-calculator`, `https://shortvidapi.com/affiliate` (20% recurring partner share).

## 2. Pricing & Unified Credit System ($1 = 10,000 Credits)

| Data Type / Endpoint | Credits | Base Cost | Effective Cost with Bonus | Page Size |
| :--- | :--- | :--- | :--- | :--- |
| Video Search, User Videos, Hashtag/Music Feeds | 2 Credits / video | $0.20 / 1,000 videos | $0.08–$0.115 / 1,000 videos | Up to 30 videos/call |
| Video Comments & Replies | 1 Credit / comment | $0.10 / 1,000 comments | $0.06 / 1,000 comments | Up to 50 comments/call |
| Followers, Following & User Search | 1 Credit / user | $0.10 / 1,000 users | $0.06 / 1,000 users | Up to 200 users/call |
| Single 1080p Video Parser, Profile, Hashtag/Sound Info | 10 Credits / call | $1.00 / 1,000 calls | $0.60 / 1,000 calls | 1 object + 1080p MP4 |
| Creative Center Commercial Ads (/v1/ads/*) | 10 Credits / ad | $1.00 / 1,000 ads | $0.60 / 1,000 ads | Up to 20 ads/call |

- **Plans & One-Time Credit Packs**: Indie Micro-Pack ($9 one-time · 75,000 Credits · never expires · 120 RPM), Starter ($19/mo or $25 PAYG · 250,000 Credits · 120 RPM), Pro ($69/mo or $89 PAYG · 1,200,000 Credits · 300 RPM), Business ($199/mo or $249 PAYG · 5,000,000 Credits · 600 RPM). Paid via Stripe (Card, Apple Pay, Google Pay, official PDF invoices) or 0%-fee Crypto (USDT, USDC, BTC, ETH, SOL).

## 3. Standardized /v1/ Route Mapping Table

Both modern plural routes and legacy compatible routes are supported on `https://api.shortvidapi.com`:

- `GET /v1/videos/detail?url={url}&hd=1` (alias: `GET /v1/video/detail`) — 1080p no-watermark MP4 (`hdplay`) & full metadata
- `GET /v1/videos/search?query={kw}&limit=30&cursor=0&region=US&publish_time=0&sort_by=0` (alias: `GET /v1/video/search`)
- `GET /v1/users/profile?username={handle}` (alias: `GET /v1/user/info`) — resolves `@username` to numeric `user_id` and `secUid`
- `GET /v1/users/videos?username={handle}&limit=33&cursor=0` (alias: `GET /v1/user/posts`)
- `GET /v1/users/followers?user_id={uid}&limit=200&cursor=0` (alias: `GET /v1/user/followers`)
- `GET /v1/users/following?user_id={uid}&limit=200&cursor=0` (alias: `GET /v1/user/following`)
- `GET /v1/users/search?query={kw}&limit=30&cursor=0` (alias: `GET /v1/user/search`)
- `GET /v1/videos/comments?url={url}&limit=50&cursor=0` (alias: `GET /v1/comment/list`)
- `GET /v1/videos/comments/replies?video_id={vid}&comment_id={cid}&limit=50&cursor=0` (alias: `GET /v1/comment/reply`)
- `GET /v1/hashtags/info?hashtag={name}` (alias: `GET /v1/challenge/info`)
- `GET /v1/hashtags/videos?hashtag_id={cid}&limit=30&cursor=0` (alias: `GET /v1/challenge/posts`)
- `GET /v1/sounds/info?sound={id_or_url}` (alias: `GET /v1/music/info`)
- `GET /v1/sounds/videos?sound_id={mid}&limit=30&cursor=0` (alias: `GET /v1/music/posts`)
- `GET /v1/videos/trending?region=US&limit=20` (alias: `GET /v1/feed/list`)
- `GET /v1/ads/search?keyword={kw}&country_code=US&period=7&sort_by=impression&page=1&limit=20` (alias: `GET /v1/ads/top/ads`)
- `GET /v1/ads/detail?ad_id={id}` (alias: `GET /v1/ads/top/ads/detail`)

## 4. Complete Endpoint Reference & Code Samples

### Get video or photo carousel detail & 1080p no-watermark URL (`GET /v1/video/detail`)
- **Documentation URL**: https://shortvidapi.com/docs/video-detail
- **Cost**: 10 Credits / request ($1.00 / 1K requests)
- **Description**: Fetch full metadata, engagement metrics, creator profile, music track, image carousel slides, and direct 1080p HD no-watermark download links (`data.play`, `data.hdplay`) for any public TikTok video.
- **Parameters**:
  - `url` (query, required): TikTok video URL, short link (`vm.tiktok.com`), or numeric video ID. [example: `https://www.tiktok.com/@tiktok/video/7106594312292453675`]
  - `hd` (query, optional): Set to `1` to include the 1080p HD no-watermark stream URL in `data.hdplay`. [example: `1`]

```bash
curl "https://api.shortvidapi.com/v1/video/detail?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7106594312292453675" \
  -H "x-api-key: tk_your_api_key"
```

```python
import requests

res = requests.get(
    "https://api.shortvidapi.com/v1/video/detail?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7106594312292453675",
    headers={"x-api-key": "tk_your_api_key"},
    timeout=30,
)
print(res.json())
```

---

### Search videos by keyword (`GET /v1/video/search`)
- **Documentation URL**: https://shortvidapi.com/docs/video-search
- **Cost**: 2 Credits / video (min 10 Credits) ($0.20 / 1K videos)
- **Description**: Search public TikTok videos by keyword with filters for region, sort order, and publish time window. Every video item includes direct no-watermark playback links and full engagement statistics. Paginated via `cursor` and `hasMore`.
- **Parameters**:
  - `keywords` (query, required): Search keywords, e.g. `ai tools` or `skincare routine`. [example: `ai tools`]
  - `count` (query, optional): Number of videos to return per page (max 30). [example: `20`]
  - `cursor` (query, optional): Pagination offset cursor (`0` for first page, then pass `data.cursor` from the previous response). [example: `0`]
  - `region` (query, optional): Two-letter ISO country code (`US`, `GB`, `JP`, `DE`, `BR`, etc.). [example: `US`]
  - `sort_type` (query, optional): Sort order: `0` = Relevance, `1` = Most Liked, `3` = Newest. [example: `0`]
  - `publish_time` (query, optional): Publish window filter: `0` = All time, `1` = Yesterday, `7` = Past 7 days, `30` = Past 30 days, `90` = Past 3 months, `180` = Past 6 months. [example: `0`]

```bash
curl "https://api.shortvidapi.com/v1/video/search?keywords=ai+tools" \
  -H "x-api-key: tk_your_api_key"
```

```python
import requests

res = requests.get(
    "https://api.shortvidapi.com/v1/video/search?keywords=ai+tools",
    headers={"x-api-key": "tk_your_api_key"},
    timeout=30,
)
print(res.json())
```

---

### Get creator profile & account statistics (`GET /v1/user/info`)
- **Documentation URL**: https://shortvidapi.com/docs/user-info
- **Cost**: 10 Credits / request ($1.00 / 1K requests)
- **Description**: Fetch a TikTok creator's public profile (`data.user`: `id`, `uniqueId`, `nickname`, `secUid`, `verified`, `signature`, `language`, `isBusinessAccount`, `category`, `commerceUserInfo`, `isOrganization`, `ttSeller`, `bioLink`, privacy settings, avatars) and real-time counters (`data.stats`: `followerCount`, `followingCount`, `friendCount`, `heartCount`, `videoCount`, `diggCount`). Returns 0-credit charge when an account handle does not exist.
- **Parameters**:
  - `unique_id` (query, required): Creator handle without `@`, e.g. `tiktok` or `khaby.lame`. [example: `tiktok`]

```bash
curl "https://api.shortvidapi.com/v1/user/info?unique_id=tiktok" \
  -H "x-api-key: tk_your_api_key"
```

```python
import requests

res = requests.get(
    "https://api.shortvidapi.com/v1/user/info?unique_id=tiktok",
    headers={"x-api-key": "tk_your_api_key"},
    timeout=30,
)
print(res.json())
```

---

### Get creator's public video posts (`GET /v1/user/posts`)
- **Documentation URL**: https://shortvidapi.com/docs/user-posts
- **Cost**: 2 Credits / video (min 10 Credits) ($0.20 / 1K videos)
- **Description**: Paginated list of public videos and photo carousels posted by a creator (`data.videos`), newest first, including canonical `video_url` / `share_url`, `content_type` (`video` or `image`), direct unwatermarked MP4 streams (`play`, `no_watermark_url`, `has_watermark`, `video_format`, `bitrate_kbps`), `hashtags`, `mentioned_user_ids`, parsed POI location (`location_name`, `poi`), disclosure flags (`is_pinned`, `is_ad`, `is_paid_partnership`, `is_ecommerce`), music metadata, and full engagement statistics (`play_count`, `digg_count`, `comment_count`, `share_count`, `collect_count`, `download_count`). Pass `unique_id`, `user_id`, or `sec_uid`.
- **Parameters**:
  - `unique_id` (query, required): Creator handle without `@`, e.g. `tiktok`. [example: `tiktok`]
  - `count` (query, optional): Number of videos per page (max 35). [example: `20`]
  - `cursor` (query, optional): Pagination cursor (`0` for the first page, then pass `data.cursor`). [example: `0`]

```bash
curl "https://api.shortvidapi.com/v1/user/posts?unique_id=tiktok" \
  -H "x-api-key: tk_your_api_key"
```

```python
import requests

res = requests.get(
    "https://api.shortvidapi.com/v1/user/posts?unique_id=tiktok",
    headers={"x-api-key": "tk_your_api_key"},
    timeout=30,
)
print(res.json())
```

---

### Search creator accounts (`GET /v1/user/search`)
- **Documentation URL**: https://shortvidapi.com/docs/user-search
- **Cost**: 1 Credit / user (min 10 Credits) ($0.10 / 1K users)
- **Description**: Discover TikTok creators by keyword with optional filters for follower tier and verification status. Paginated via `cursor` and `has_more`.
- **Parameters**:
  - `keywords` (query, required): Search keywords or username query. [example: `ai`]
  - `cursor` (query, optional): Pagination cursor (`0` for first page, then pass `data.cursor`). [example: `0`]
  - `follower_count` (query, optional): Follower count tier: `0` = Any, `1` = 0–1K, `2` = 1K–10K, `3` = 10K–100K, `4` = 100K+. [example: `0`]
  - `profile_type` (query, optional): Verification filter: `0` = Any, `1` = Verified accounts only. [example: `0`]
  - `search_emphasis` (query, optional): Search scope: `0` = General, `1` = Username match only. [example: `0`]

```bash
curl "https://api.shortvidapi.com/v1/user/search?keywords=ai" \
  -H "x-api-key: tk_your_api_key"
```

```python
import requests

res = requests.get(
    "https://api.shortvidapi.com/v1/user/search?keywords=ai",
    headers={"x-api-key": "tk_your_api_key"},
    timeout=30,
)
print(res.json())
```

---

### Get user followers list (`GET /v1/user/followers`)
- **Documentation URL**: https://shortvidapi.com/docs/user-followers
- **Cost**: 1 Credit / user (min 10 Credits) ($0.10 / 1K followers)
- **Description**: Paginated list of accounts following a creator (`data.followers`), up to 200 per request. First retrieve `user_id` and `sec_uid` from `/v1/user/info`, then pass `data.min_time` as `time` for subsequent pages.
- **Parameters**:
  - `user_id` (query, required): Numeric TikTok user ID (`data.user.id` from `/v1/user/info`). [example: `107955`]
  - `sec_uid` (query, optional): SecUID (`data.user.secUid` from `/v1/user/info`). Recommended for reliability. [example: `MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM`]
  - `count` (query, optional): Number of followers per request (max 200). [example: `50`]
  - `time` (query, optional): Pagination timestamp cursor (`0` for first page, then pass `data.min_time`). [example: `0`]

```bash
curl "https://api.shortvidapi.com/v1/user/followers?user_id=107955" \
  -H "x-api-key: tk_your_api_key"
```

```python
import requests

res = requests.get(
    "https://api.shortvidapi.com/v1/user/followers?user_id=107955",
    headers={"x-api-key": "tk_your_api_key"},
    timeout=30,
)
print(res.json())
```

---

### Get user following list (`GET /v1/user/following`)
- **Documentation URL**: https://shortvidapi.com/docs/user-following
- **Cost**: 1 Credit / user (min 10 Credits) ($0.10 / 1K followings)
- **Description**: Paginated list of accounts that a creator follows (`data.followings`), up to 200 per request. Pass `data.min_time` as `time` for subsequent pages.
- **Parameters**:
  - `user_id` (query, required): Numeric TikTok user ID (`data.user.id` from `/v1/user/info`). [example: `107955`]
  - `sec_uid` (query, optional): SecUID (`data.user.secUid` from `/v1/user/info`). [example: `MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM`]
  - `count` (query, optional): Number of accounts per request (max 200). [example: `50`]
  - `time` (query, optional): Pagination timestamp cursor (`0` for first page, then pass `data.min_time`). [example: `0`]

```bash
curl "https://api.shortvidapi.com/v1/user/following?user_id=107955" \
  -H "x-api-key: tk_your_api_key"
```

```python
import requests

res = requests.get(
    "https://api.shortvidapi.com/v1/user/following?user_id=107955",
    headers={"x-api-key": "tk_your_api_key"},
    timeout=30,
)
print(res.json())
```

---

### Get top-level video comments (`GET /v1/comment/list`)
- **Documentation URL**: https://shortvidapi.com/docs/comment-list
- **Cost**: 1 Credit / comment (min 10 Credits) ($0.10 / 1K comments)
- **Description**: Paginated top-level comments on a TikTok video (`data.comments`), up to 50 per page, including commenter profile, like count, and reply count.
- **Parameters**:
  - `url` (query, required): TikTok video URL or numeric video ID. [example: `https://www.tiktok.com/@tiktok/video/7106594312292453675`]
  - `count` (query, optional): Number of comments per page (max 50). [example: `20`]
  - `cursor` (query, optional): Pagination cursor (`0` for first page, then pass `data.cursor`). [example: `0`]

```bash
curl "https://api.shortvidapi.com/v1/comment/list?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7106594312292453675" \
  -H "x-api-key: tk_your_api_key"
```

```python
import requests

res = requests.get(
    "https://api.shortvidapi.com/v1/comment/list?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7106594312292453675",
    headers={"x-api-key": "tk_your_api_key"},
    timeout=30,
)
print(res.json())
```

---

### Get second-level comment replies (`GET /v1/comment/reply`)
- **Documentation URL**: https://shortvidapi.com/docs/comment-reply
- **Cost**: 1 Credit / comment (min 10 Credits) ($0.10 / 1K comments)
- **Description**: Paginated nested replies (`data.comments`) under a top-level comment (`comment_id`). Accepts either `url` or `video_id` to identify the video.
- **Parameters**:
  - `url` (query, required): TikTok video URL or numeric video ID (`video_id` is also accepted). [example: `7106594312292453675`]
  - `comment_id` (query, required): Top-level comment ID (`id` from `/v1/comment/list`). [example: `7106598090963878662`]
  - `count` (query, optional): Number of replies per page (max 50). [example: `20`]
  - `cursor` (query, optional): Pagination cursor (`0` for first page, then pass `data.cursor`). [example: `0`]

```bash
curl "https://api.shortvidapi.com/v1/comment/reply?url=7106594312292453675&comment_id=7106598090963878662" \
  -H "x-api-key: tk_your_api_key"
```

```python
import requests

res = requests.get(
    "https://api.shortvidapi.com/v1/comment/reply?url=7106594312292453675&comment_id=7106598090963878662",
    headers={"x-api-key": "tk_your_api_key"},
    timeout=30,
)
print(res.json())
```

---

### Get hashtag (challenge) detail & total views (`GET /v1/challenge/info`)
- **Documentation URL**: https://shortvidapi.com/docs/challenge-info
- **Cost**: 10 Credits / request ($1.00 / 1K requests)
- **Description**: Look up a hashtag by name to retrieve its numeric `cid` (`data.id`), description, video count (`data.userCount`), and total view count (`data.viewCount`).
- **Parameters**:
  - `challenge_name` (query, required): Hashtag name without `#`, e.g. `fyp` or `tiktokmademebuyit`. [example: `fyp`]

```bash
curl "https://api.shortvidapi.com/v1/challenge/info?challenge_name=fyp" \
  -H "x-api-key: tk_your_api_key"
```

```python
import requests

res = requests.get(
    "https://api.shortvidapi.com/v1/challenge/info?challenge_name=fyp",
    headers={"x-api-key": "tk_your_api_key"},
    timeout=30,
)
print(res.json())
```

---

### Get videos under a hashtag (`GET /v1/challenge/posts`)
- **Documentation URL**: https://shortvidapi.com/docs/challenge-posts
- **Cost**: 2 Credits / video (min 10 Credits) ($0.20 / 1K videos)
- **Description**: Paginated list of videos tagged with a hashtag (`data.videos`), including no-watermark video URLs and engagement stats. Pass `cid` (or `challenge_id`) obtained from `/v1/challenge/info`.
- **Parameters**:
  - `cid` (query, required): Numeric hashtag ID (`data.id` from `/v1/challenge/info`; `challenge_id` is also accepted). [example: `42164`]
  - `count` (query, optional): Number of videos per page (max 30). [example: `20`]
  - `cursor` (query, optional): Pagination cursor (`0` for first page, then pass `data.cursor`). [example: `0`]

```bash
curl "https://api.shortvidapi.com/v1/challenge/posts?cid=42164" \
  -H "x-api-key: tk_your_api_key"
```

```python
import requests

res = requests.get(
    "https://api.shortvidapi.com/v1/challenge/posts?cid=42164",
    headers={"x-api-key": "tk_your_api_key"},
    timeout=30,
)
print(res.json())
```

---

### Get sound / music track detail (`GET /v1/music/info`)
- **Documentation URL**: https://shortvidapi.com/docs/music-info
- **Cost**: 10 Credits / request ($1.00 / 1K requests)
- **Description**: Retrieve metadata for a TikTok sound or original audio track (`data.id`, `data.title`, `data.author`, `data.play` MP3 URL, `data.video_count`).
- **Parameters**:
  - `url` (query, required): TikTok music URL or numeric music ID. [example: `7106594322274962182`]

```bash
curl "https://api.shortvidapi.com/v1/music/info?url=7106594322274962182" \
  -H "x-api-key: tk_your_api_key"
```

```python
import requests

res = requests.get(
    "https://api.shortvidapi.com/v1/music/info?url=7106594322274962182",
    headers={"x-api-key": "tk_your_api_key"},
    timeout=30,
)
print(res.json())
```

---

### Get videos using a sound / music track (`GET /v1/music/posts`)
- **Documentation URL**: https://shortvidapi.com/docs/music-posts
- **Cost**: 2 Credits / video (min 10 Credits) ($0.20 / 1K videos)
- **Description**: Paginated list of videos that use a specific sound (`data.videos`), including no-watermark playback streams and stats.
- **Parameters**:
  - `music_id` (query, required): Numeric music ID (`data.id` from `/v1/music/info`). [example: `7106594322274962182`]
  - `count` (query, optional): Number of videos per page (max 30). [example: `20`]
  - `cursor` (query, optional): Pagination cursor (`0` for first page, then pass `data.cursor`). [example: `0`]

```bash
curl "https://api.shortvidapi.com/v1/music/posts?music_id=7106594322274962182" \
  -H "x-api-key: tk_your_api_key"
```

```python
import requests

res = requests.get(
    "https://api.shortvidapi.com/v1/music/posts?music_id=7106594322274962182",
    headers={"x-api-key": "tk_your_api_key"},
    timeout=30,
)
print(res.json())
```

---

### Get regional trending video feed (`GET /v1/feed/list`)
- **Documentation URL**: https://shortvidapi.com/docs/feed-list
- **Cost**: 2 Credits / video (min 10 Credits) ($0.20 / 1K videos)
- **Description**: Fetch currently trending TikTok videos for a specific country/region (`data`: array of video objects with direct no-watermark URLs and full engagement statistics).
- **Parameters**:
  - `region` (query, required): Two-letter ISO country code (`US`, `GB`, `DE`, `BR`, `JP`, `KR`, etc.). [example: `US`]
  - `count` (query, optional): Number of trending videos to return. [example: `20`]

```bash
curl "https://api.shortvidapi.com/v1/feed/list?region=US" \
  -H "x-api-key: tk_your_api_key"
```

```python
import requests

res = requests.get(
    "https://api.shortvidapi.com/v1/feed/list?region=US",
    headers={"x-api-key": "tk_your_api_key"},
    timeout=30,
)
print(res.json())
```

---

### Search top-performing TikTok Creative Center ads (`GET /v1/ads/top/ads`)
- **Documentation URL**: https://shortvidapi.com/docs/ads-top-ads
- **Cost**: 10 Credits / ad (min 10 Credits) ($1.00 / 1K ads)
- **Description**: Query top-performing commercial ads from TikTok Creative Center (`data.materials`), filtered by country, time window, and ranking metric (`impression`, `ctr`, `like`).
- **Parameters**:
  - `country_code` (query, optional): Two-letter country code (`US`, `GB`, `CA`, `DE`, `JP`, etc.). [example: `US`]
  - `period` (query, optional): Time range in days (`7`, `30`, or `180`). [example: `7`]
  - `order_by` (query, optional): Ranking metric: `impression`, `ctr`, or `like`. [example: `impression`]
  - `page` (query, optional): Page number (starts at `1`). [example: `1`]
  - `limit` (query, optional): Ads per page (max 20). [example: `20`]

```bash
curl "https://api.shortvidapi.com/v1/ads/top/ads" \
  -H "x-api-key: tk_your_api_key"
```

```python
import requests

res = requests.get(
    "https://api.shortvidapi.com/v1/ads/top/ads",
    headers={"x-api-key": "tk_your_api_key"},
    timeout=30,
)
print(res.json())
```

---

### Get commercial ad detail & 1080p video source (`GET /v1/ads/top/ads/detail`)
- **Documentation URL**: https://shortvidapi.com/docs/ads-top-ads-detail
- **Cost**: 10 Credits / request ($1.00 / 1K requests)
- **Description**: Fetch full creative performance metrics, ad objective, landing page link, brand name, and direct 720p/1080p video source (`data.video_info.video_url`) for a Creative Center ad (`ads_id` or `material_id`).
- **Parameters**:
  - `ads_id` (query, required): Creative Center ad material ID (`id` from `/v1/ads/top/ads`; `material_id` is also accepted). [example: `7206035139393372162`]

```bash
curl "https://api.shortvidapi.com/v1/ads/top/ads/detail?ads_id=7206035139393372162" \
  -H "x-api-key: tk_your_api_key"
```

```python
import requests

res = requests.get(
    "https://api.shortvidapi.com/v1/ads/top/ads/detail?ads_id=7206035139393372162",
    headers={"x-api-key": "tk_your_api_key"},
    timeout=30,
)
print(res.json())
```

## 5. Engineering Guides & Tutorials

### Unofficial TikTok API vs Official TikTok API: Complete 2026 Developer Guide
- **URL**: https://shortvidapi.com/guides/unofficial-tiktok-api
- **Summary**: Compare Official TikTok Display/Research APIs vs Unofficial Data APIs. Fetch public profiles, 1080p MP4s, comments, and ads without OAuth login.
- **Key Takeaways**:
  - The Official TikTok Display API requires per-user OAuth 2.0 login and only returns videos owned by the authenticated user — you cannot look up arbitrary public creators, hashtags, or competitors.
  - The Official TikTok Research API is restricted to vetted non-profit academic institutions and prohibits commercial SaaS, brand monitoring, or AI training use cases.
  - An independent gateway like ShortVid API provides instant REST access to 16 public data endpoints (profiles, video search, 1080p unwatermarked streams, comments, followers, and Creative Center ads) with a single API key.
  - ShortVid API charges only for successful responses (code === 0) starting at $0.20 per 1,000 videos or $0.10 per 1,000 comments/followers, with 10,500 free credits ($1.05) on signup.

### How to Get TikTok Video Metadata & 1080p No-Watermark MP4 via API
- **URL**: https://shortvidapi.com/guides/tiktok-api-get-video
- **Summary**: Fetch TikTok video metadata, engagement stats, audio tracks, photo carousels, and direct 1080p no-watermark MP4 URLs via REST API in Python & JS.
- **Key Takeaways**:
  - Pass any TikTok full URL (tiktok.com/@user/video/123), short share link (vm.tiktok.com / vt.tiktok.com), or raw numeric video ID to GET /v1/videos/detail (or /v1/video/detail).
  - Set hd=1 (enabled by default) to receive both the fast standard unwatermarked stream (data.play) and the 1080p original HD stream (data.hdplay).
  - For TikTok Photo Mode (carousel posts), the endpoint automatically populates data.images[] with full-resolution unwatermarked image URLs alongside the background audio track.
  - Each successful video lookup costs a flat 10 Credits ($0.001 base, or $0.0004 on Business Monthly). Invalid URLs or deleted videos return code != 0 and cost 0 Credits.

### TikTok Search API Guide: Search Videos, Creators & Commercial Ads by Keyword
- **URL**: https://shortvidapi.com/guides/tiktok-api-search
- **Summary**: Search TikTok videos, creator accounts, and Creative Center ads by keyword, country, publish window, and sort order with the ShortVid API REST API.
- **Key Takeaways**:
  - Use GET /v1/videos/search (or /v1/video/search) to search public videos by keyword with filters for region (US, GB, JP, DE, etc.), publish_time (yesterday, 7d, 30d, 90d, 180d), and sort_by (Relevance, Most Liked, Newest).
  - Every video item returned in search results already includes direct no-watermark MP4 playback links (play) and full engagement counters — no second N+1 lookup required.
  - Use GET /v1/users/search to discover creators filtered by follower count tier (follower_tier) and verification badge (verified_only).
  - Use GET /v1/ads/search to query TikTok Creative Center top-performing commercial ads by keyword, country, time period, and ranking metric (impression, ctr, like).

### TikAPI Pricing Breakdown (2026): Real Cost per 1,000 Videos & Pay-As-You-Go Comparison
- **URL**: https://shortvidapi.com/guides/tikapi-pricing
- **Summary**: 2026 breakdown of TikAPI (tikapi.io) pricing tiers, page multipliers, and subscription lock-in vs ShortVid API ($0.20/1K videos, never-expiring PAYG).
- **Key Takeaways**:
  - Legacy providers price by 'API request' while capping each page at 30 videos or 30 followers — meaning 1,000,000 followers requires ~33,334 requests.
  - ShortVid API returns up to 200 followers per request and bills transparently by item ($0.20 / 1K videos, $0.10 / 1K comments or followers at base rate; down to $0.08 / 1K videos with Business bonus).
  - Unlike monthly-only subscriptions where unused quota expires every 30 days, ShortVid API offers both discounted Monthly Subscriptions (+25% to +65% bonus credits) and Never-Expiring Pay-As-You-Go packs.
  - Migrating from tikapi.io or similar REST wrappers takes less than 5 minutes by pointing your base URL to https://api.shortvidapi.com/v1.

### Fix TikTok HTTP Error 403 ("Access to www.tiktok.com Was Denied") — Working Python & API Bypass
- **URL**: https://shortvidapi.com/guides/tiktok-error-403
- **Summary**: Fix TikTok HTTP Error 403 ('Access to www.tiktok.com was denied' & '403 Forbidden') in Chrome, Python & yt-dlp — or bypass 403 via API with 0 proxies.
- **Key Takeaways**:
  - TikTok returns HTTP 403 Forbidden (or HTTP 200 with a 0-byte Content-Length body) when a request lacks valid X-Bogus / X-Argus / msToken signatures or originates from a flagged cloud datacenter ASN (AWS, GCP, Hetzner, DigitalOcean).
  - The Chrome/Edge interstitial "Access to www.tiktok.com was denied. You don't have authorization to view this page. HTTP ERROR 403" comes from TikTok's Akamai/ByteDance Edge WAF flagging VPN, proxy, or cloud datacenter IPs.
  - The Safari/HTTP client message "The server at www.tiktok.com sent back an error: 403 Forbidden" typically indicates missing cryptographic query tokens, blocked TLS JA3/JA4 fingerprints, or expired x-expires CDN video links.
  - Calling GET https://api.shortvidapi.com/v1/video/detail or /v1/user/info offloads signature generation, residential IP rotation, and fresh 1080p CDN link signing so your code never hits TikTok 403 blocks.

### TikTok Ads Library & Creative Center API: Scrape Winning Ads, CTR & Keywords
- **URL**: https://shortvidapi.com/guides/tiktok-ads-library-api
- **Summary**: Search the TikTok Creative Center Commercial Ads Library via REST API. Fetch winning ad creatives, CTR/CVR tiers, landing URLs, and ad keywords.
- **Key Takeaways**:
  - Unlike TikAPI and most unofficial scrapers that only cover organic posts, ShortVid API includes full access to the TikTok Creative Center Commercial Ads Library (/v1/ads/search and /v1/ads/detail).
  - Search commercial ads by product keyword (e.g., 'bracelet', 'serum', 'ai app'), target country (US, GB, DE, JP, BR, etc.), time window (7, 30, or 180 days), and sort by impression, like, or ctr.
  - Every ad record includes the clean MP4 creative URL, advertiser brand name, CTA button text, external landing page URL, and performance metrics.
  - Combine /v1/ads/search with /v1/ads/detail to inspect full advertiser profiles, multi-resolution video streams, and regional targeting across 60+ countries.

### TikTok Comments & Replies Scraper API: Extract Threads at $0.10/1K
- **URL**: https://shortvidapi.com/guides/tiktok-comments-scraper-api
- **Summary**: Scrape TikTok video comments and nested reply threads via REST API at $0.10 per 1,000 comments (50/call). Includes cursor pagination & Python code.
- **Key Takeaways**:
  - GET /v1/videos/comments (alias GET /v1/comment/list) returns up to 50 top-level comments per request at 1 Credit ($0.0001) per comment — $0.10 per 1,000 comments.
  - Every comment object includes cid (comment ID), text, digg_count (likes), reply_comment_total, create_time, and commenter profile metadata (uid, unique_id, sec_uid).
  - When reply_comment_total > 0, call GET /v1/videos/comments/replies (alias GET /v1/comment/reply) with video_id and comment_id to paginate nested sub-threads.
  - Zero cookies, browser automation, or CAPTCHA solving required; failed or 0-comment lookups cost 0 Credits.

### TikTok Profile & Followers Scraper API: Fetch User Data, Videos & 200-Item Follower Lists
- **URL**: https://shortvidapi.com/guides/tiktok-user-profile-followers-api
- **Summary**: TikTok followers scraper & profile API: fetch public user data, bio stats, 1080p videos (33/call), and paginated follower lists (200/call) without OAuth.
- **Key Takeaways**:
  - Unlike TikTok Display API or TikTok Studio (which require each creator to grant OAuth login), GET /v1/users/profile lets you fetch TikTok user data for any public @username immediately.
  - GET /v1/users/profile returns user.id (immutable numeric user_id), user.secUid, bio signature, verified badge, and real-time followerCount, heartCount, and videoCount.
  - TikTok Followers Scraper endpoint (GET /v1/users/followers and GET /v1/users/following) returns up to 200 follower accounts per request — 6.6x larger than legacy scrapers that cap pages at 30 users.
  - GET /v1/users/videos returns up to 33 public videos per request, complete with 1080p no-watermark MP4 URLs and engagement counts.

### TikTok Analytics API & Python Guide: Creator Engagement, Video Velocity & Studio Metrics
- **URL**: https://shortvidapi.com/guides/tiktok-analytics-api
- **Summary**: Extract TikTok creator analytics, engagement rates, video velocity, and studio metrics via Python & REST API from $0.20/1K videos. Free 500-credit trial.
- **Key Takeaways**:
  - ByteDance's native TikTok Studio and Display APIs only expose analytics for accounts where the creator manually grants OAuth 2.0 permission — making competitor benchmarking and influencer discovery impossible.
  - With ShortVid API, a single GET /v1/user/info + GET /v1/user/posts pipeline returns full engagement counters (play_count, digg_count, comment_count, share_count, collect_count) for any public creator at $0.20 per 1,000 videos.
  - You can compute true Engagement Rate by Views ((likes + comments + shares + saves) / views) and 24-hour Viral Velocity directly from the Unix create_time timestamp in under 40 lines of Python.
  - Every video item also includes AI comment sentiment inputs (/v1/comment/list) and 1080p no-watermark MP4 links (hdplay) for multimodal vision/audio analysis.

### TikTok Influencer Search API: Find Creators by Niche & Follower Tier
- **URL**: https://shortvidapi.com/guides/tiktok-influencer-search-api
- **Summary**: Search TikTok influencers by niche keyword, follower tier (10K–100K, 100K+), and verified badge via REST API. Extract engagement rates & bio contacts.
- **Key Takeaways**:
  - GET /v1/user/search lets you query TikTok creators by niche keyword with native server-side filters for follower tier (follower_count: 1=0–1K, 2=1K–10K, 3=10K–100K, 4=100K+) and verified status (profile_type=1).
  - Creator search costs 1 Credit per returned creator ($0.10 per 1,000 creators at base rate, down to $0.04/1K on Business).
  - Combine /v1/user/search with /v1/user/posts (2 Credits/video) to filter out inactive accounts and rank influencers by median non-pinned views and save-to-view ratio.
  - Interactive testing: try the free TikTok Bio Email Extractor and Engagement Rate Calculator under /tools.

### How to Extract Creator Emails & Bio Leads from TikTok via API (Python & Node.js)
- **URL**: https://shortvidapi.com/guides/tiktok-email-lead-generation-api
- **Summary**: Build an automated TikTok email scraper and B2B creator lead pipeline in Python & JS. Extract emails, Linktree URLs, and IG handles at $0.10/1K users.
- **Key Takeaways**:
  - Between 18% and 34% of mid-tier TikTok creators (10K–250K followers) publish a direct business inquiry email in their profile signature (e.g. 'mgmt@...', 'collab@...').
  - By combining GET /v1/user/search (niche keyword discovery) and GET /v1/user/followers (lookalike audience harvesting from seed creators), you can generate thousands of targeted creator leads per hour.
  - Our production Python normalizer handles both standard emails and obfuscated formats ('[at]', '(at)', '📩') alongside Linktree/Beacons domains.
  - You can test bio email extraction right in your browser using our free /tools/tiktok-bio-email-extractor tool.

### TikTok Hashtag, Sound & Viral Trends API: Track Breakout Topics in Real Time
- **URL**: https://shortvidapi.com/guides/tiktok-hashtag-sound-trends-api
- **Summary**: Track viral TikTok hashtags, breakout original sounds, and regional trending videos via REST API. Get challenge IDs, view counts, and audio velocity.
- **Key Takeaways**:
  - GET /v1/challenge/info resolves any hashtag name (without #) into its numeric challenge_id, total cumulative view_count, and total video user_count (10 Credits / call).
  - GET /v1/challenge/posts and GET /v1/music/posts stream up to 30 tagged videos per call (2 Credits / video) complete with play_count, share_count, collect_count, and 1080p MP4 links.
  - Music labels and A&R teams poll GET /v1/music/info (10 Credits / call) to track daily video creation velocity (user_count delta) on emerging sound IDs.
  - GET /v1/feed/list provides real-time regional trending videos by ISO country code (US, GB, DE, JP, KR, BR).

### n8n & Make.com TikTok API Integration: Automate Video & Creator Workflows
- **URL**: https://shortvidapi.com/guides/n8n-make-tiktok-api-automation
- **Summary**: Connect ShortVid API to n8n, Make.com, and Zapier using one HTTP Request node. Automate competitor video alerts, 1080p MP4 downloads, and AI analysis.
- **Key Takeaways**:
  - Every ShortVid API endpoint is a stateless HTTPS GET request authenticated via a single x-api-key header — making it 100% compatible with n8n's HTTP Request node, Make.com's HTTP module, and Zapier Webhooks.
  - No OAuth refresh tokens, cookies, or proxy configuration required inside your workflow canvas.
  - Common automations: daily competitor post alerts to Slack, automatic 1080p no-watermark MP4 ingestion into OpenAI Whisper / Gemini 1.5 Pro, and Airtable/Google Sheets influencer CRM enrichment.
  - For Claude Desktop and Cursor AI agents, use our native MCP server: npx -y @kaitoinfra/shortvidapi-mcp-server.

### TikTok Shop Affiliate & E-Commerce Product Intelligence via API
- **URL**: https://shortvidapi.com/guides/tiktok-shop-affiliate-creator-api
- **Summary**: Discover high-converting TikTok Shop affiliate creators, commerce videos, and winning e-commerce ad creatives via REST API. Full Python & Node.js guide.
- **Key Takeaways**:
  - Identify active TikTok Shop affiliate creators in any product category by querying GET /v1/video/search and GET /v1/challenge/posts for commerce hashtags (#tiktokshopfinds, #tiktokmademebuyit) and filtering for commerce-enabled posts.
  - Benchmark paid e-commerce creatives with GET /v1/ads/top/ads filtered by country_code, period (7/30/180 days), and order_by=ctr or impression.
  - Vet affiliate creators before sending product samples by computing their median non-pinned views and save-to-view ratio (collect_count / play_count) via GET /v1/user/posts.
  - Extract direct inquiry emails from creator bios via GET /v1/user/info to automate affiliate seeding outreach.

### TikTok Research API: Academic Eligibility, 1,000/Day Quota & Commercial REST Endpoints
- **URL**: https://shortvidapi.com/guides/tiktok-research-api
- **Summary**: Complete TikTok Research API guide: university eligibility rules, 1,000 daily request quota, field limits, and instant commercial REST API endpoints.
- **Key Takeaways**:
  - The Official TikTok Research API is restricted to researchers employed by accredited non-profit academic institutions in the US, Europe, and select regions. For-profit companies, SaaS platforms, marketing agencies, and AI labs are ineligible.
  - Approved academic projects receive a strict daily quota of 1,000 requests per day (up to 100 records per request) and must submit research proposals 4–8 weeks in advance.
  - The Research API returns text metadata only — it does not expose direct 1080p MP4 video streams, audio files, or TikTok Creative Center commercial ad analytics.
  - If your team is ineligible for academic access or requires commercial SLA throughput, you can map every Research API query (video search, user info, comments, followers) to ShortVid API's 16 public REST endpoints in 30 seconds.

### TikTok Display API: OAuth 2.0 Scopes, Limitations & How to Fetch Public Profiles
- **URL**: https://shortvidapi.com/guides/tiktok-display-api
- **Summary**: Understand TikTok Display API OAuth 2.0 scopes (user.info.basic, video.list), why it only returns logged-in user data, and how to query public creators.
- **Key Takeaways**:
  - Every TikTok Display API endpoint requires a per-user OAuth 2.0 access_token obtained via Login Kit browser redirect.
  - The Display API only returns data belonging to the currently logged-in user (user.info.basic, user.info.stats, video.list, video.query). You cannot pass another creator's @username.
  - Each OAuth scope requires a separate TikTok Developer Portal app review with screen recordings demonstrating user consent.
  - To fetch any public creator's profile, videos, or followers by @username without asking them to log in, call GET /v1/user/info and GET /v1/user/posts on ShortVid API.

### Python TikTok API Tutorial (2026): requests, asyncio & Why Playwright Libraries Break
- **URL**: https://shortvidapi.com/guides/python-tiktok-api
- **Summary**: Scrape TikTok with Python using requests & asyncio instead of fragile Playwright/X-Bogus libraries. Fetch videos, profiles, comments, and ads in JSON.
- **Key Takeaways**:
  - Open-source PyPI packages like davidteather/TikTok-Api require local Chromium/Playwright instances, residential proxies, and manual msToken cookie extraction — and frequently break with EmptyResponseException or HTTP 403 when ByteDance rotates web signatures.
  - With ShortVid API, your Python environment needs zero headless browsers: standard requests or httpx calls against https://api.shortvidapi.com/v1/* return clean JSON in 400–900ms.
  - Built-in parameter normalization accepts both snake_case and camelCase query params (username or unique_id, keyword or keywords, country_code or region).
  - For high-throughput pipelines (up to 600 RPM), use asyncio + httpx.AsyncClient with cursor pagination and automatic exponential backoff on HTTP 429.

### TikTok Scraper API: Extract Public Videos, Profiles, Comments & Ads at Scale
- **URL**: https://shortvidapi.com/guides/tiktok-scraper-api
- **Summary**: Production TikTok Scraper API with 16 REST endpoints: scrape 1080p videos ($0.20/1K), comments, follower lists, and Creative Center ads without proxies.
- **Key Takeaways**:
  - Complete 16-endpoint coverage across 6 TikTok data domains: Videos, Users & Followers, Comments & Replies, Hashtags, Sounds/Music, and Creative Center Commercial Ads.
  - Transparent per-item unit economics: $0.20 per 1,000 videos retrieved in batch/search, $0.10 per 1,000 comments or followers, and $1.00 per 1,000 commercial ads.
  - Zero charge on failed or non-200 upstream responses — credits are only deducted when the gateway returns HTTP 200 with code === 0.
  - Synchronous HTTP GET responses (p50 latency 420–880ms) instead of waiting 30–90 seconds for container actor cold starts.

## 6. Competitor Benchmarks

### ShortVid API vs TikAPI.io (tikapi.io)
- **URL**: https://shortvidapi.com/compare/tikapi
- **Headline**: $0.20 vs $1.00+ per 1,000 videos.
- **Summary**: Legacy TikTok API providers lock you into expiring monthly subscriptions and charge per small page. ShortVid API returns up to 33 videos or 200 followers per request, includes 1080p no-watermark video streams out of the box, and cuts your data bill by up to 85%.

### ShortVid API vs Apify TikTok Scrapers (apify.com)
- **URL**: https://shortvidapi.com/compare/apify
- **Headline**: $0.20 vs $2.50+ per 1,000 videos (zero cold start).
- **Summary**: Apify Actors spin up headless Docker containers for every run — adding 15 to 45 seconds of cold-start latency, Compute Unit (CU) overhead, and monthly Actor rental fees. ShortVid API is a synchronous, sub-second REST gateway designed for real-time apps and high-throughput pipelines.

### ShortVid API vs EnsembleData (ensembledata.com)
- **URL**: https://shortvidapi.com/compare/ensembledata
- **Headline**: $0.20 vs $0.80–$1.50 per 1,000 videos (with 6.6x larger follower pages).
- **Summary**: EnsembleData enforces daily resetting unit caps and charges extra units when paginating small 30-item follower lists. ShortVid API delivers up to 200 followers per call, never charges for failed lookups, and offers both monthly plans and never-expiring Pay-As-You-Go credits.

### ShortVid API vs Official TikTok API (developers.tiktok.com)
- **URL**: https://shortvidapi.com/compare/official-api
- **Headline**: Instant vs 2–8 Weeks to start fetching public TikTok data.
- **Summary**: The Official TikTok Display API only lets you read videos of users who manually log in to your app via OAuth, while the Research API is restricted to accredited non-profit universities. ShortVid API gives commercial developers instant key-based access to any public TikTok video, profile, comment thread, and Creative Center ad.

### ShortVid API vs ScrapeCreators (scrapecreators.com)
- **URL**: https://shortvidapi.com/compare/scrapecreators
- **Headline**: $0.20 vs $1.00+ per 1,000 videos.
- **Summary**: ScrapeCreators is a generalist multi-network scraper that charges per request regardless of page density. ShortVid API is a dedicated TikTok & Creative Center Ads gateway returning up to 35 videos or 200 followers per call with built-in 1080p no-watermark MP4 streams.

### ShortVid API vs Clockworks (Apify TikTok Scraper) (apify.com/clockworks/tiktok-scraper)
- **URL**: https://shortvidapi.com/compare/clockworks-apify
- **Headline**: $0.20 vs $2.50+ per 1,000 videos.
- **Summary**: Clockworks' Apify TikTok Scraper is great for manual spreadsheet exports, but spinning up headless Actor containers introduces 15–45 second cold starts and compute unit markups. ShortVid API delivers synchronous JSON in ~240ms at $0.20/1K videos.

### ShortVid API vs RapidAPI TikTok Scrapers (rapidapi.com)
- **URL**: https://shortvidapi.com/compare/rapidapi-tiktok
- **Headline**: $0.20 vs $1.50+ per 1,000 videos.
- **Summary**: Most TikTok APIs listed on RapidAPI are thin wrappers that route your traffic through RapidAPI's proxy layer, add a 20%+ marketplace fee, and charge punitive per-call overages when an upstream node hiccups. Connect directly to ShortVid API for lower latency and transparent item-based billing.

### ShortVid API vs SociaVault (sociavault.com)
- **URL**: https://shortvidapi.com/compare/sociavault
- **Headline**: $0.20 vs $1.50+ per 1,000 videos.
- **Summary**: Multi-network social APIs price every page request uniformly while returning only 10–30 items per call. ShortVid API is purpose-built for TikTok data pipelines—delivering up to 35 videos or 200 follower profiles per request, direct 1080p no-watermark MP4 URLs, and Creative Center commercial ads in a single REST schema.

### ShortVid API vs Data365 (data365.co)
- **URL**: https://shortvidapi.com/compare/data365
- **Headline**: $19 vs $300+ monthly entry commitment.
- **Summary**: Enterprise social data vendors require sales calls, multi-hundred-dollar monthly minimums, and asynchronous POST-then-poll task queues. ShortVid API gives engineering teams instant self-serve API keys with 10,500 Free Credits ($1.05), synchronous sub-second GET responses, and $0.20 per 1,000 videos.

## 7. Frequently Asked Questions

### How does the Unified Credit System work?

$1 equals 10,000 Credits (1 Credit = $0.0001). Every endpoint deducts credits based on the data returned, with a minimum floor of 10 Credits ($0.001) per successful request: 2 Credits per video ($0.20 / 1,000 videos), 1 Credit per comment ($0.10 / 1,000 comments), 1 Credit per follower/user ($0.10 / 1,000 users), and 10 Credits ($1.00 / 1,000 calls) for single video 1080p parses or profile lookups.

### Do video endpoints include direct 1080p no-watermark download links?

Yes. Both /v1/video/detail (with hd=1) and list endpoints (/v1/video/search, /v1/user/posts, /v1/challenge/posts, /v1/music/posts, /v1/feed/list) return direct CDN links for clean no-watermark MP4 video playback (data.play and data.hdplay), original MP3 audio (data.music), and high-resolution photo carousel slides (data.images).

### Do I need to supply my own proxy IPs, browser fingerprints, or TikTok account cookies?

No. ShortVid API manages all residential proxy routing, device signing, and anti-bot token generation at the gateway layer. You simply make standard HTTPS GET requests with your x-api-key header.

### Am I charged when a request fails or is rate-limited?

Never. Only HTTP 200 responses with code === 0 deduct credits. Upstream errors, invalid URLs, rate-limited requests (HTTP 429), and gateway timeouts (HTTP 5xx) cost 0 Credits.

### Should I choose a Monthly Plan or Pay-As-You-Go (One-Time Top-Up)?

Both credit your account with unified credits that never expire. If you want the lowest entry barrier with zero monthly commitment, start with the $9 Indie Starter Pay-As-You-Go Micro-Pack (75,000 Credits · unlocks 120 RPM and 10 concurrent requests). Larger tiers offer identical credit bundles across PAYG and Monthly (Starter 250,000 Credits, Pro 1,200,000 Credits, Business 5,000,000 Credits), while Monthly subscriptions save up to 24% more for steady production workloads.

### What are the concurrency, pagination, and RPM rate limits?

Free Trial accounts include 10,500 Credits, 60 RPM (5 req/sec), and full cursor pagination across all 16 endpoints for evaluation. Paid accounts scale from 120 RPM (Starter) and 300 RPM (Pro) up to 600 RPM (Business). Our gateway also runs an adaptive RPM watermark scheduler with multi-key pool failover to prevent HTTP 429 spikes under burst traffic.

### What payment methods are accepted?

You can pay instantly by credit or debit card (Visa, Mastercard, American Express, Apple Pay, and Google Pay via Stripe with automatic official PDF invoices and VAT/Tax ID support) or top up with cryptocurrency (USDT or USDC on Tron, BNB Smart Chain, Ethereum, Solana, Arbitrum, and Polygon, plus BTC, SOL, and BNB).

### Can I use ShortVid API inside Claude Desktop, Cursor, or No-Code workflows?

Yes. Run npx -y @kaitoinfra/shortvidapi-mcp-server with your SHORTVIDAPI_KEY to give Claude Desktop, Cursor, or Windsurf native TikTok search, creator analysis, and video parsing tools. For no-code spreadsheet exports, use our ready-made actors on Apify.

### How does ShortVid API (Tik Tok API) compare to the Official TikTok API for Python and Node.js?

Unlike the Official TikTok Display and Research APIs—which require per-user OAuth 2.0 login or non-profit academic approval—ShortVid API (often searched as Tik Tok API or Python TikTok API) lets any developer query public TikTok videos, 1080p no-watermark MP4 streams, creator analytics, comments, followers, and Creative Center ads with a single REST API key from Python, Node.js, Go, or cURL.

### Is ShortVid API affiliated with TikTok or ByteDance?

No. ShortVid API is an independent developer infrastructure provider for publicly available data and is not affiliated with, endorsed by, or sponsored by TikTok or ByteDance Ltd.

### How much does it cost to fetch 100,000 TikTok videos or followers?

At 2 Credits per video ($0.20 / 1,000 videos, up to 30 videos per call), 100,000 videos cost $20 base (or $11.50 on the Pro plan). At 1 Credit per follower (up to 200 followers per call), 100,000 followers cost $10 base (or $5.75 on the Pro plan) — up to 80% lower than legacy scraping platforms.

### What is your refund policy?

Payments made within the last 30 days can be refunded up to the unused purchased balance on your account. Promotional signup credits have no cash value.