API Get Video List by TikTok User¶

Overview¶

This API returns a list of videos from a TikTok user with pagination support (min_revid / max_revid cursor).

Pricing¶

15 credits per request

Fixed cost per request regardless of media duration or file size.

Endpoint¶

URL: POST https://api.revidapi.com/paid/tiktok/username
Method: POST

Request¶

Headers¶

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

Query parameters¶

Parameter	Type	Required	Description
`username`	string	✅	TikTok username, e.g. `@username` or `username`
`limit`	int	❌	Max number of videos (1-100). Default: 50. TikTok max: 12
`min_revid`	string	❌	Pagination cursor: start after this video ID (use previous response `max_revid`)

Examples¶

POST https://api.revidapi.com/paid/tiktok/username?username=@username&limit=12
POST https://api.revidapi.com/paid/tiktok/username?username=@username&limit=12&min_revid=7123456789

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

Response¶

Success response (200)¶

{
  "username": "@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
`username`	string	Requested TikTok username
`items`	array	Video list
`items[].url`	string	Video page URL (use `/download` with this URL to download)
`items[].title`	string	Video title
`items[].duration`	int \| null	Duration (seconds)
`items[].thumbnail`	string \| null	Thumbnail URL
`items[].uploader`	string \| null	User name
`items[].revid`	string \| null	Video ID for pagination
`count`	int	Number of items in `items`
`limited_to`	int	Applied limit
`min_revid`	string \| null	First video ID in current batch
`max_revid`	string \| null	Last video ID in current batch; pass as next `min_revid`
`source`	string	`revidapi.com`
`cached`	boolean	`true` if response is served from cache

Pagination (TikTok)¶

TikTok supports up to 12 items/request.
For next page, send: min_revid=<max_revid from previous response>.
In some environments, tiktok_cookies.txt may be required for stable crawling.

Error response¶

Status	Description
502	Unable to fetch videos (cookies, rate limit, invalid username). Check `detail` for guidance.

Usage notes¶

Workflow: Call /paid/tiktok/username to fetch list -> use items[].url -> call /download for each URL.
Pagination: Use max_revid from current response as min_revid in next call.
Cache: Some responses may return cached: true (default TTL: 1200s).