---
title: "Tiktok Channel Videos"
method: POST
path: "/tiktok/channel-videos"
tags: ["TikTok"]
---

# Tiktok Channel Videos

`POST /tiktok/channel-videos`

## Request

- Base URL: `https://api.fetchfox.net`
- URL: `https://api.fetchfox.net/tiktok/channel-videos`
- Auth: API key in header `x-access-key`

Get recent TikTok videos with bounded recovery. Paid requests allow up to 120 seconds; failures use zero credits.

## Request body

- object, nullable
  - `url` string, required: Full URL of the resource
  - `limit` integer: Maximum number of results to return
  - `cursor` string: Pagination cursor from a previous response
  - `access_key` string: Deprecated: use the x-access-key header. Keys in URLs can leak through browser history and intermediary logs. Retained only for existing clients.
  - `cache` boolean: Opt in to successful response caching. Successful requests use the normal operation credit rate, including cached responses.
  - `cache_ttl` integer: Maximum response age in seconds. Default 86400; no stale fallback.
  - `no_cache` boolean: Bypass all extraction and result caches.
  - `country` string: Residential exit country (two-letter code).

## Response `200`

Channel videos retrieved successfully

- object: Channel videos retrieved successfully
  - `success` boolean, required
  - `data` object, required
    - `profileUrl` string
    - `channelName` string
    - `results` object[]
      - `videoId` string
      - `description` string
      - `url` string
      - `thumbnail` string
      - `duration` number
      - `createTime` string
      - `durationSeconds` unknown
      - `thumbnailUrl` unknown
      - `publishedAt` unknown
      - `views` integer
      - `likes` integer
      - `comments` integer
      - `shares` integer
      - `collects` integer
    - `hasMore` boolean
    - `cursor` string

## Other responses

- `400`: Invalid or missing request input
- `401`: Access key is missing
- `403`: Access key is invalid or the project has insufficient credits
- `404`: Content not found or unavailable
- `422`: Unsupported input or documented media restriction
- `429`: Project rate limit exceeded
- `500`: Internal server error
- `502`: Upstream query rejected or malformed response
- `503`: Upstream service temporarily unavailable; retry later
- `504`: Extraction or upstream operation timed out

---

[API](https://skmtc.dev/fetchfox/apis/project-api.md) · [All operations](https://skmtc.dev/fetchfox/apis/project-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fetchfox/apis/project-api/revisions/b664f61ca9f3?raw)