dvcrn CreatorCrawl TikTok Data
Access live TikTok data: creator profiles, video analytics, comments, transcripts, search, trending content, and songs. 19 endpoints, structured JSON responses, no scraping required.
Setup
Get a free API key at https://creatorcrawl.com (250 free credits, no card required). Set the CREATORCRAWL_API_KEY environment variable.
How to call the API
Use curl for all requests. Authenticate with the x-api-key header. Base URL: https://creatorcrawl.com.
curl -s -H "x-api-key: $CREATORCRAWL_API_KEY" \
"https://creatorcrawl.com/api/tiktok/profile?handle=charlidamelio"
All responses are JSON. Errors return { "success": false, "error": "message" } with status 400 (bad params), 401 (unauthorized), 402 (no credits), or 502 (upstream).
Endpoints
Profiles
GET /api/tiktok/profile — Get a creator's profile, stats, and recent videos.
| Param | Required | Description |
|---|---|---|
| handle | yes | TikTok handle (without @) |
Returns: user info (id, uniqueId, nickname, signature, verified), stats (followerCount, followingCount, heartCount, videoCount), and recent videos.
GET /api/tiktok/profile/videos — Get a creator's videos with pagination and sorting.
| Param | Required | Description |
|---|---|---|
| handle | yes | TikTok handle |
| sort_by | no | latest or popular |
| max_cursor | no | Pagination cursor from previous response |
| region | no | 2-letter country code |
Returns: aweme_list with statistics (play_count, digg_count, comment_count, share_count), author info, music info. Paginate with max_cursor.
GET /api/tiktok/user/followers — Get a creator'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 |
GET /api/tiktok/user/following — Get accounts a creator follows.
| Param | Required | Description |
|---|---|---|
| handle | yes | TikTok handle |
| min_time | no | Pagination cursor |
GET /api/tiktok/user/live — Check if a creator is live streaming.
| Param | Required | Description |
|---|---|---|
| handle | yes | TikTok handle |
Videos
GET /api/tiktok/video — Get full video details.
| Param | Required | Description |
|---|---|---|
| url | yes | TikTok video URL |
| get_transcript | no | true to include transcript |
| region | no | 2-letter country code |
Returns: aweme_detail with statistics, author, music, video dimensions, hashtags, and optional transcript.
GET /api/tiktok/video/comments — Get 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.
GET /api/tiktok/video/transcript — Get 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) |
Search
GET /api/tiktok/search/keyword — Search videos by keyword.
| Param | Required | Description |
|---|---|---|
| query | yes | Search keyword |
| date_posted | no | yesterday, this-week, this-month, last-3-months, last-6-months, all-time |
| sort_by | no | relevance, most-liked, date-posted |
| region | no | 2-letter country code |
| cursor | no | Pagination cursor |
GET /api/tiktok/search/hashtag — Search videos by hashtag.
| Param | Required | Description |
|---|---|---|
| hashtag | yes | Hashtag without # |
| region | no | 2-letter country code |
| cursor | no | Pagination cursor |
GET /api/tiktok/search/users — Search TikTok users.
| Param | Required | Description |
|---|---|---|
| query | yes | Search query |
| cursor | no | Pagination cursor |
GET /api/tiktok/search/top — Top search results (videos + photo carousels).
| Param | Required | Description |
|---|---|---|
| query | yes | Search keyword |
| publish_time | no | yesterday, this-week, this-month, last-3-months, last-6-months, all-time |
| sort_by | no | relevance, most-liked, date-posted |
| region | no | 2-letter country code |
| cursor | no | Pagination cursor |
Trending
GET /api/tiktok/get-trending-feed — Get trending feed for a region.
| Param | Required | Description |
|---|---|---|
| region | yes | 2-letter country code (US, GB, FR, etc.) |
GET /api/tiktok/videos/popular — Get 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 |
GET /api/tiktok/creators/popular — Discover popular creators with filters.
| Param | Required | Description |
|---|---|---|
| page | no | Page number |
| sortBy | no | engagement, follower, avg_views |
| followerCount | no | 10K-100K, 100K-1M, 1M-10M, 10M+ |
| creatorCountry | no | Creator's country code |
| audienceCountry | no | Audience country code |
GET /api/tiktok/hashtags/popular — Get trending hashtags.
| 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
GET /api/tiktok/song — Get song details by clip ID.
| Param | Required | Description |
|---|---|---|
| clipId | yes | Clip ID (not song ID) |
GET /api/tiktok/song/videos — Get videos using a specific song.
| Param | Required | Description |
|---|---|---|
| clipId | yes | Clip ID from song URL |
| cursor | no | Pagination cursor |
GET /api/tiktok/songs/popular — Get popular/surging songs (can take up to 30s).
| Param | Required | Description |
|---|---|---|
| page | no | Page number |
| timePeriod | no | 7, 30, or 130 (days) |
| rankType | no | popular or surging |
| newOnBoard | no | New to top 100 |
| commercialMusic | no | Approved for business use |
| countryCode | no | Country code |
Pagination
Paginated endpoints return a cursor field (cursor, min_time, or max_cursor depending on the endpoint). Pass it back as a query param for the next page. Stop when the cursor is empty/null or no more items are returned.
Pricing
1 credit per API call. Free signup gives 250 credits. Paid packs: Starter ($29/5k credits), Pro ($99/20k credits), Scale ($299/100k credits). Credits never expire, no rate limits.