Skip to content

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).

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://api.revidapi.com/paid/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://api.revidapi.com/paid/tiktok/channel?url=https://www.tiktok.com/@username&limit=12
POST https://api.revidapi.com/paid/tiktok/channel?url=https://www.tiktok.com/@username&limit=12&min_revid=7123456789
curl -X POST "https://api.revidapi.com/paid/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
}

Usage Notes

  1. Workflow: Call /channel to get list → use items[].url → call /download with each URL to download video.
  2. Pagination: Use max_revid from response as min_revid for next request.