tiktok-scraper — tiktok-抓取器

创建器Crawl TikTok Data

访问 live TikTok data: 创建器 性能分析s, video 分析, comments, transcripts, 搜索, trending content, and songs. 19 端点s, structured JSON 响应s, no scrAPIng required.

设置up

获取 a free API key at https://创建器crawl.com (250 free credits, no card required). 设置 the 创建器CRAWL_API_KEY 环境 variable.

How to call the API

Use curl for all 请求s. 认证 with the x-API-key header. Base URL: https://创建器crawl.com.

curl -s -H "x-API-key: $创建器CRAWL_API_KEY" \ "https://创建器crawl.com/API/tiktok/性能分析?handle=charlidamelio"

All 响应s are JSON. Errors return { "成功": false, "error": "message" } with 状态 400 (bad params), 401 (un授权d), 402 (no credits), or 502 (up流).

端点s 性能分析s

获取 /API/tiktok/性能分析 — 获取 a 创建器's 性能分析, stats, and recent videos.

Param Required Description handle yes TikTok handle (without @)

Returns: user 信息 (id, uniqueId, nickname, 签名ature, verified), stats (followerCount, followingCount, heartCount, videoCount), and recent videos.

获取 /API/tiktok/性能分析/videos — 获取 a 创建器's videos with pagination and 排序ing.

Param Required Description handle yes TikTok handle 排序_by no latest or popular max_cursor no Pagination cursor from previous 响应 region no 2-letter country code

Returns: aweme_列出 with statistics (play_count, digg_count, comment_count, 分享_count), author 信息, music 信息. Paginate with max_cursor.

获取 /API/tiktok/user/followers — 获取 a 创建器's followers (paginated).

Param Required Description handle yes (or user_id) TikTok handle user_id yes (or handle) User ID (faster) min_time no Pagination cursor

获取 /API/tiktok/user/following — 获取 accounts a 创建器 follows.

Param Required Description handle yes TikTok handle min_time no Pagination cursor

获取 /API/tiktok/user/live — 检查 if a 创建器 is live 流ing.

Param Required Description handle yes TikTok handle Videos

获取 /API/tiktok/video — 获取 full video detAIls.

Param Required Description url yes TikTok video URL 获取_transcript no true to include transcript region no 2-letter country code

Returns: aweme_detAIl with statistics, author, music, video dimensions, 哈希tags, and optional transcript.

获取 /API/tiktok/video/comments — 获取 video comments (paginated).

Param Required Description url yes TikTok video URL cursor no Pagination cursor

Returns: comments with text, digg_count, reply_comment_total, nested replies.

获取 /API/tiktok/video/transcript — 获取 video transcript text.

Param Required Description url yes TikTok video URL language no 2-letter language code (en, es, fr) use_AI_as_fallback no true for AI transcription (under 2 min videos) 搜索

获取 /API/tiktok/搜索/keyword — 搜索 videos by keyword.

Param Required Description 查询 yes 搜索 keyword date_posted no yesterday, this-week, this-month, last-3-months, last-6-months, all-time 排序_by no relevance, most-liked, date-posted region no 2-letter country code cursor no Pagination cursor

获取 /API/tiktok/搜索/哈希tag — 搜索 videos by 哈希tag.

Param Required Description 哈希tag yes 哈希tag without # region no 2-letter country code cursor no Pagination cursor

获取 /API/tiktok/搜索/users — 搜索 TikTok users.

Param Required Description 查询 yes 搜索 查询 cursor no Pagination cursor

获取 /API/tiktok/搜索/top — Top 搜索 结果s (videos + photo carousels).

Param Required Description 查询 yes 搜索 keyword publish_time no yesterday, this-week, this-month, last-3-months, last-6-months, all-time 排序_by no relevance, most-liked, date-posted region no 2-letter country code cursor no Pagination cursor Trending

获取 /API/tiktok/获取-trending-feed — 获取 trending feed for a region.

Param Required Description region yes 2-letter country code (US, GB, FR, etc.)

获取 /API/tiktok/videos/popular — 获取 popular videos across TikTok.

Param Required Description period no 7 or 30 (days) page no Page number orderBy no like, hot, comment, repost countryCode no Country code

获取 /API/tiktok/创建器s/popular — Discover popular 创建器s with 过滤器s.

Param Required Description page no Page number 排序By no engagement, follower, avg_views followerCount no 10K-100K, 100K-1M, 1M-10M, 10M+ 创建器Country no 创建器's country code audienceCountry no Audience country code

获取 /API/tiktok/哈希tags/popular — 获取 trending 哈希tags.

Param Required Description period no 7, 30, or 120 (days) page no Page number countryCode no Country code newOnBoard no Only newly trending industry no e.g. beauty-and-personal-care, food-and-beverage, tech-and-electronics Songs

获取 /API/tiktok/song — 获取 song detAIls by 命令行工具p ID.

Param Required Description 命令行工具pId yes 命令行工具p ID (not song ID)

获取 /API/tiktok/song/videos — 获取 videos using a specific song.

Param Required Description 命令行工具pId yes 命令行工具p ID from song URL cursor no Pagination cursor

获取 /API/tiktok/songs/popular — 获取 popular/surging songs (can take up to 30s).

Param Required Description page no Page numbe