Get Channel API¶

Overview¶

The Get Channel API retrieves a list of videos from a channel/user with pagination support (cursor via min_revid / max_revid).

Pricing¶

15 credits per request

Fixed cost per request, regardless of video length or file size.

Tested and working: TikTok (user). Other platforms (YouTube, Facebook, Instagram, …) may work; Facebook page/group does not support listing videos (yt-dlp limitation).

Endpoint¶

URL: POST https://revidapi.com/v1/tiktok/channel
Method: POST

Request¶

Headers¶

x-api-key: Required (if API requires authentication).

Query parameters¶

Parameter	Type	Required	Description
`url`	string	✅	Channel/user URL (YouTube, TikTok, Facebook, Instagram, Bilibili, …), min 6 chars
`limit`	int	❌	Max videos (1–100). Default: 50. TikTok/FB/Instagram/YouTube Shorts max 12
`min_revid`	string	❌	Pagination cursor: start after video with this ID (use `max_revid` from previous response)

Example¶

POST https://revidapi.com/v1/tiktok/channel?url=https://www.tiktok.com/@username&limit=12
POST https://revidapi.com/v1/tiktok/channel?url=https://www.tiktok.com/@username&limit=12&min_revid=7123456789

curl -X POST "https://revidapi.com/v1/tiktok/channel?url=https://www.tiktok.com/@username&limit=12" \
  -H "x-api-key: YOUR_API_KEY"

Response¶

Success Response (200)¶

{
  "url": "https://www.tiktok.com/@user",
  "items": [
    {
      "url": "https://www.tiktok.com/@user/video/7123456789",
      "title": "Video title",
      "duration": 15,
      "thumbnail": "https://...",
      "uploader": "user",
      "revid": "7123456789"
    }
  ],
  "count": 12,
  "limited_to": 12,
  "min_revid": "7123456789",
  "max_revid": "7123456700",
  "source": "revidapi.com",
  "cached": false
}

Response Fields¶

Field	Type	Description
`url`	string	Channel URL sent
`items`	array	List of videos
`items[].url`	string	Video page URL (call `/download` with this URL to download)
`items[].title`	string	Title
`items[].duration`	int \| null	Duration (seconds)
`items[].thumbnail`	string \| null	Thumbnail URL
`items[].uploader`	string \| null	Channel/user name
`items[].revid`	string \| null	Video ID (for pagination)
`count`	int	Number of items in `items`
`limited_to`	int	Limit applied
`min_revid`	string \| null	First video ID in batch
`max_revid`	string \| null	Last video ID — send as `min_revid` for next request
`source`	string	`revidapi.com`
`cached`	boolean	`true` if from cache

Pagination (TikTok)¶

TikTok: max 12 items/request. Next request: min_revid=<max_revid from previous response>.
May require tiktok_cookies.txt on server for stable operation.

Error Response¶

Status	Description
502	Could not fetch videos (cookies, rate limit, invalid URL). `detail` has guidance.

Usage Notes¶

Workflow: Call /channel to get list → use items[].url → call /download with each URL to download video.
Pagination: Use max_revid from response as min_revid for next request.
Cache: Some responses have cached: true when from cache (default TTL 1200s).