Profile
1 credit/v1/tiktok/profileGet TikTok user profile.
handle, user_id
TikTok APIScrape TikTok data with one API
Fetch public TikTok profiles, videos, comments, sounds, and search as structured JSON with one SocialCrawl API key. Same Post, Comment, and Author schema as every other platform. Reads are priced in credits.
/v1/tiktok
20 active endpoints
- GET /v1/tiktok/profile
- GET /v1/tiktok/profile/full
- GET /v1/tiktok/profile/videos
- GET /v1/tiktok/post
- GET /v1/tiktok/post/comments
- GET /v1/tiktok/post/transcript
- GET /v1/tiktok/search
- GET /v1/tiktok/search/hashtag
- GET /v1/tiktok/song
- GET /v1/tiktok/trending
What TikTok endpoints does SocialCrawl ship?
20 live read endpoints for public TikTok data. Profiles, video posts, comment pages, transcripts, hashtag and keyword search, sounds, and trending surfaces. Data API only. No posting or private DMs.
Full profile
5 credits/v1/tiktok/profile/fullTikTok profile, recent posts, and computed analytics in one call.
handle, user_id, posts, cursor
Profile videos
1 credit/v1/tiktok/profile/videosList TikTok user videos.
handle, user_id, sort_by, max_cursor, region
Post
1 credit/v1/tiktok/postGet TikTok post details.
url, region, trim, download_media
Post comments
1 credit/v1/tiktok/post/commentsList TikTok post comments.
url, cursor, trim
Post transcript
10 credits/v1/tiktok/post/transcriptGet TikTok video transcript.
url, language, use_ai_as_fallback
Search
1 credit/v1/tiktok/searchSearch TikTok videos by keyword.
query, date_posted, sort_by, region, cursor
Hashtag search
1 credit/v1/tiktok/search/hashtagSearch TikTok by hashtag.
hashtag, region, cursor, trim
Sound
1 credit/v1/tiktok/songGet TikTok song details.
clipId
Trending
5 credits/v1/tiktok/trendingGet TikTok trending feed.
region, trim
TikTok API33 endpoints supported
View docsReturns a TikTok account's public profile: display name, bio, follower count on author.followers (or the rounded figure with author.ext.followers_approximate), likes, verification, and user id.
Use it when you have a handle and want a quick snapshot of an account before pulling its videos or followers.
1 credit
GET/v1/tiktok/profile?handle=charlidamelio
$ curl https://www.socialcrawl.dev/v1/tiktok/profile?handle=charlidamelio \
-H "x-api-key: sc_YOUR_API_KEY"idle
// Edit the params above and hit "Try it" to run a live request against the APIHow the TikTok API works
TikTok is a normal SocialCrawl social surface. You call GET /v1/tiktok/… with an API key, spend credits on live misses, and get a single JSON envelope back. No TikTok developer app. No second SDK.
Authenticate every call
Send your key in the x-api-key header. The same key works across the SocialCrawl catalog.
GET with query params
Routes are GET. Pass handles, urls, queries, and cursors as query strings. We validate formats before charging.
Pay in credits, not seats
Live misses debit the route tier. Cache hits cost 0. Empty or hard failures refund.
Read one JSON envelope
Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached.
The usual integration chain
Most products resolve a handle, page videos, then deepen only the posts that matter.
01Profile
GET /v1/tiktok/profileAuthor-shaped account: bio, followers, likes, user id
Resolve the handle once before listing content.
02Videos
GET /v1/tiktok/profile/fullPostList of recent public videos with metrics
Page with cursor. Optional trim for a smaller payload.
03Post body
GET /v1/tiktok/profile/videosFull Post including sound and video metadata
Search titles are not enough when you need the video record.
04Comments
GET /v1/tiktok/postCommentList page for one video
Expand replies with video/comment/replies when a thread matters.
request
GET /v1/tiktok/profile
?handle=example
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_hereresponse envelope
{
"success": true,
"data": { "/* Author | Post | PostList | CommentList | … */": true },
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}What lands in data
Field names match the rest of SocialCrawl where archetypes align.
Authorprofile
id, username, display_name, avatar_url, bio, followers, engagement totals, url, ext
PostList / Postprofile/full
items[].post with id, url, content, engagement (views, likes, comments, shares), author, published_at, sound/media ext
CommentListprofile/videos
items[] with author, content.text, engagement, published_at; pagination cursor when more remains
Transcript / Analyticspost
spoken text from captions or AI fallback; profile/full engagement rollups
Inside the gateway
Same request lifecycle as every other /v1 platform endpoint.
- 01
Edge receives the call
Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit and concurrency.
- 02
Validate, then debit
Registry lookup finds the route. Required params run first. Invalid input returns 400 with no charge. Valid calls debit before upstream work.
- 03
Cache or fetch
A deterministic cache key is built from platform + resource + params. Hit: credits_used = 0. Miss: upstream fetch with retries and circuit breaker.
- 04
Normalize and return
Upstream JSON is mapped to Author / Post / PostList / CommentList (or route archetype), validated, wrapped in the success envelope, and logged for billing audit.
Billing rules that matter in production
- Standard live miss: tier cost (often 1 credit)
- Advanced reads: typically 5 credits
- Premium reads: typically 10 credits
- Metered routes: min floor when documented
- Cache hit: 0 credits
- Empty / hard fail: auto-refund
- Bad params: 400, never charged
- No credits: 402, never charged
- Disabled routes: 503, never charged
How we get the data
TikTok is public-read social data. We normalize it into the SocialCrawl schema so your code does not learn a second OAuth flow or raw upstream shapes.
What TikTok is for this API
Public profiles, videos, comments, sounds, and search. Read-only surface for research, monitoring, and product jobs. No posting or private inbox access.
How SocialCrawl reaches it
Public endpoints are read live on request and normalized at our edge before they reach you. Prism composites such as profile/full combine multiple legs into one call when you opt in.
What leaves our edge
A unified JSON envelope: success, data, credits_used, request_id, cached. Profiles become Author objects. Posts and comments share the same leaves as other platforms.
What we do not ship live
No write endpoints. No private messages. Disabled or soft-failed routes stay out of the active count. Prefer registry docs for the live inventory.
field map sketch
public profile / channel→ author.*handle, bio, followers, like totals
public post / media→ post.* / items[].postcaption, views, likes, comments, sound
comment page / tree→ CommentList items[]comment text, likes, reply counts, cursor
What this API is used for
The jobs this API is most often used for.
20active TikTok endpoints in the registry
1 / 5 / 10credit ladder for standard, advanced, premium reads
Creator monitoring and short-form content intelligence
Callers concentrate on profile to videos chains, keyword and hashtag search, and post to comments when a video spikes. Structured TikTok JSON on the shared schema, transcripts when you need spoken text, and one key across the rest of SocialCrawl.
Profile and post detail are typically a few seconds on live miss. Search and fat profile composites are slower social-read paths.
What people build with the TikTok API
The jobs TikTok data is most often used for. Each one is a full recipe with the endpoint chain and pricing.
Use case examples
Common ways teams put this data to work, and the stack each one tends to run.
Creator ops
Python, cron, Slack botsPoll profile/videos for a fixed handle set. Alerts when views or comment velocity jumps.
Brand and VoC teams
Node, notebooks, BI loadsHashtag and keyword search, then expand post and comments for product language and competitor clips.
Backend product jobs
Go, workers, ExplorerWire profile to videos to post to comments into pipelines. Cache hits keep recurring runs cheap.
Call it in two lines
Standard tier is one credit per live call on most reads. Cache hits are free. Advanced and premium rungs cost more.
curl "https://www.socialcrawl.dev/v1/tiktok/profile?handle=example" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/tiktok/profile/full?handle=example" \
-H "x-api-key: sc_your_api_key_here"Same key as the rest of the catalog
Endpoints
What data does the TikTok API return?
Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.
ProfileGet TikTok user profileProfile VideosList TikTok user videosPostGet TikTok post detailsPost CommentsList TikTok post commentsVideo Comment RepliesList TikTok comment repliesCommentLook up one TikTok comment by URL or idSearchSearch TikTok videos by keywordTrendingGet TikTok trending feedSearch HashtagSearch TikTok by hashtagSearch TopTikTok top search resultsSearch UsersSearch TikTok usersUser AudienceGet TikTok user audience demographicsUser FollowersList TikTok user followersUser FollowingList TikTok user followingUser LiveGet TikTok user live streamPost TranscriptGet TikTok video transcriptVideo Screen TextGet TikTok video on-screen textSongGet TikTok song detailsSong VideosList TikTok videos using a songProfile RegionGet TikTok profile regionAdlibrary SearchSearch the TikTok Ad LibraryAdlibrary AdGet a TikTok Ad Library adSearch SuggestionsGet TikTok search suggestionsCollection VideosList videos in a TikTok collectionProfile PlaylistsList a TikTok account's playlistsPlaylist VideosList videos in a TikTok playlistUser LikedList the videos a TikTok account has likedLocation PostsList TikTok videos tagged at a placeEffectsGet TikTok effects by idEffect VideosList TikTok videos made with an effectSearch MusicSearch TikTok soundsHashtagGet TikTok hashtag detailsProfile FullTikTok profile, recent posts, and computed analytics in one call.
Comparison
How does SocialCrawl compare to Official TikTok API for TikTok data?
Same TikTok data, two very different paths. Auth, rate limits, schema, and cost, side by side.
| Feature | SocialCrawl | Official TikTok API |
|---|---|---|
| Authentication | One x-api-key header | OAuth 2.0 client keys with user access tokens |
| Setup / approval | Sign up and call in under a minute | Developer app registration and review before any data access |
| Rate limits | Pay per request in credits, with no daily quota | Per-app daily quotas set by TikTok |
| Data coverage | Public profiles, videos, comments, search, trending, songs, transcripts, and audience data | Scoped to authorized users; Research API restricted to qualified researchers |
| Response schema | Unified JSON envelope shared across 51 platforms | TikTok-specific payloads per endpoint |
| Pricing | From 1 credit per request, 100 free credits to start | Free within approved quotas |
| Maintenance | Schema stays stable when TikTok changes its frontend | Official support, versioned deprecations, and content posting for authorized accounts |
Authentication
SocialCrawl
One x-api-key header
Official TikTok API
OAuth 2.0 client keys with user access tokens
Setup / approval
SocialCrawl
Sign up and call in under a minute
Official TikTok API
Developer app registration and review before any data access
Rate limits
SocialCrawl
Pay per request in credits, with no daily quota
Official TikTok API
Per-app daily quotas set by TikTok
Data coverage
SocialCrawl
Public profiles, videos, comments, search, trending, songs, transcripts, and audience data
Official TikTok API
Scoped to authorized users; Research API restricted to qualified researchers
Response schema
SocialCrawl
Unified JSON envelope shared across 51 platforms
Official TikTok API
TikTok-specific payloads per endpoint
Pricing
SocialCrawl
From 1 credit per request, 100 free credits to start
Official TikTok API
Free within approved quotas
Maintenance
SocialCrawl
Schema stays stable when TikTok changes its frontend
Official TikTok API
Official support, versioned deprecations, and content posting for authorized accounts
FAQ
Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usIs there a TikTok scraper API that works without login?
Yes. A TikTok scraper API returns profiles, videos, comments and search results as structured JSON with no login and no OAuth. SocialCrawl covers 19 TikTok endpoints behind one schema, so the same fields come back whether you are reading TikTok, Instagram or YouTube.
How do I scrape TikTok data with an API?
Send a GET request to any of the 33 SocialCrawl TikTok endpoints with an x-api-key header. Each endpoint returns structured JSON in a unified envelope. Computed fields such as engagement_rate and estimated_reach appear only when the endpoint supports them and the required source inputs are present.
What does the SocialCrawl TikTok API cover?
The TikTok API covers 33 endpoints: Profile, Profile Videos, Post, Post Comments, Video Comment Replies, Comment, Search, Trending, Search Hashtag, Search Top, Search Users, User Audience, User Followers, User Following, User Live, Post Transcript, Video Screen Text, Song, Song Videos, Profile Region, Ad Library Search, Ad Library Ad, Search Suggestions, Collection Videos, Profile Playlists, Playlist Videos, User Liked, Location Posts, Effects, Effect Videos, Search Music, Hashtag, and Profile Full. TikTok Shop endpoints live under the separate TikTok Shop platform.
How much does the TikTok API cost?
Most endpoints cost 1 credit (standard tier). Advanced endpoints like the trending feed and audience demographics cost 5 credits. New accounts get 100 free credits with no credit card required, so you can pull around 100 requests before paying anything.
Is scraping TikTok data legal?
SocialCrawl reads only publicly visible TikTok data through the same interfaces your browser uses. Make sure your use case complies with TikTok's terms of service and applicable data protection regulations like GDPR and CCPA. SocialCrawl operates under a documented GDPR legitimate-interest framework: public, logged-out data only, no credential use, short-lived caches (2 to 30 minutes) with no persistent store, and a public opt-out channel for anyone whose public info appears in responses. Full details: socialcrawl.dev/legal/public-data-notice.
Can I use the TikTok API in production?
Yes. SocialCrawl normalizes all 33 TikTok endpoints into a single unified schema, so your code keeps working when TikTok changes their interface. Response times stay consistent under load with built-in upstream retries.
Does the TikTok API work for TikTok Shop?
Yes. Five dedicated endpoints cover TikTok Shop: shop/product, shop/product/reviews, shop/products, shop/search, and user/showcase. Each returns prices, ratings, reviews, and seller details in the unified schema.
What is the best TikTok scraper API?
SocialCrawl covers 33 TikTok endpoints, including profiles, videos, comments, search, trending, songs, transcripts, audience demographics, and more, behind one x-api-key, from 1 credit per request with 100 free credits on signup. For posting content or official partner features, TikTok's own developer API remains the right tool.
Does TikTok have a data API?
Yes, and SocialCrawl is the fastest TikTok data API for reading public data: profiles, videos, comments, keyword and hashtag search, trending feeds, songs, and video transcripts, all as unified JSON from one x-api-key. TikTok's own Research and Business API is the official route, but access is gated to qualified researchers and approved commercial partners, so it is not open for general public-data reads. SocialCrawl covers 33 TikTok endpoints from 1 credit per request with 100 free credits on signup, no developer approval required.
TikTok scraping API vs the official TikTok API: what's the difference?
With SocialCrawl there is no app review or approval queue. Sign up and call TikTok endpoints immediately with a single x-api-key. Responses share one unified schema with every other SocialCrawl platform, and credit-based pricing replaces per-platform quotas. Official APIs are still the right choice for posting and other write actions: SocialCrawl is read-only data.
Ask AI about SocialCrawl