TikTok scraper API

Extract TikTok post, profile, comment and media data — no scraping setup, no TikTok login required.

原始信息汇总

TikTok Scraper API 数据集概述

该API提供了一种无需登录TikTok或自行搭建爬虫即可直接提取TikTok结构化数据的方法，支持获取帖子详情、用户资料、评论以及媒体文件。

主要功能

• 帖子详情：通过帖子URL或ID获取作者、标题、统计信息（点赞、分享、评论、播放量）、封面图、音乐信息和媒体链接。
• 视频下载：通过帖子URL或TikTok CDN链接获取以base64格式返回的媒体文件，支持画质选择。
• 用户资料：通过个人主页URL或用户名获取简介、头像、统计信息（关注、粉丝、获赞）和认证状态。
• 评论：获取帖子评论，包括作者信息和点赞数，支持游标分页。
• 识别方式：帖子支持完整URL或帖子ID，用户支持个人主页URL或用户名。

技术特点

• 无维护负担：自动适配TikTok数据结构和反爬机制变化。
• 一致响应格式：所有端点返回结构化的JSON数据。
• 结构化错误处理：每个错误响应包含error_code，验证失败时还包含reason_code。
• 无需准备TikTok账号：无需管理Cookie、会话或浏览器。

端点及路径

端点名称	路径	用途
Post details	/scrape/by-url	通过URL获取帖子完整元数据
Post details by ID	/scrape/by-id	通过帖子ID获取元数据
User profile	/scrape/user_details	获取用户资料与统计
Comments	/scrape/comments_scraper	获取帖子评论，支持分页
Video/photo download	/scrape/video-download	获取帖子媒体文件（base64格式）

请求参数要求

• 帖子详情：需要url（完整帖子URL）。
• 帖子详情（按ID）：需要post_id（5-100字符），可选username。
• 用户资料：需要profile_url或unique_id（用户名）。
• 评论：需要post_url或post_id，可选cursor（默认0）和count（默认20，最大50）。
• 视频/图片下载：需要url（帖子URL或CDN URL），可选quality和include_base64。
• 缺少必要参数将返回400 REQUEST_VALIDATION_ERROR，并附带reason_code: MISSING_REQUIRED_QUERY。

分页说明

仅评论端点支持分页。响应中包含cursor和hasMore字段，当hasMore为true时，将cursor作为查询参数传入可获取下一页。

错误代码

error_code	HTTP状态码	含义
REQUEST_VALIDATION_ERROR	400	查询参数错误或缺失
URL_BUILD	400	无法构建有效的TikTok URL
HTTP_ERROR	502*	上游请求TikTok失败
PARSE_ERROR	422	无法解析TikTok响应
SUSPECT_RESPONSE	206	响应疑似为机器人检测页面
NETWORK_ERROR	503	网络连接TikTok失败

*HTTP_ERROR在已知时会携带TikTok的真实状态码（如404），否则默认返回502。

验证错误的详细原因代码（reason_code）

reason_code	含义
MISSING_REQUIRED_QUERY	缺少必要参数
INVALID_URL_FORMAT	URL不是可解析的TikTok链接
WRONG_ENDPOINT_FOR_PROFILE_URL	将个人主页URL发到了帖子端点
WRONG_ENDPOINT_FOR_POST_URL	将帖子URL发到了个人主页端点
INVALID_POST_ID	post_id长度不在5-100字符范围内
INVALID_USERNAME	用户名为空或过长
INVALID_UNIQUE_ID	用户名格式无效
INVALID_CURSOR	cursor为负数
INVALID_COUNT	count不在1-50范围内

搜集汇总

背景与挑战

背景概述

该数据集是一个API接口，用于提取TikTok的帖子、个人资料、评论和媒体数据。用户无需进行爬虫设置或登录TikTok账户即可直接获取数据，简化了数据采集流程。