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.

CODEBLOCK0

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: awemelist with statistics (playcount, diggcount, commentcount, 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 userid)	TikTok handle
userid

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, diggcount, replycomment_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) |
| useaias_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	INLINECODE27 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	INLINECODE40, 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.