Creator profile analysis
Use TikTok endpoints to turn creator profile analysis into repeatable API requests with documented inputs and JSON responses.
Track creator and video activity, discover sounds and LIVE streams, and study public ad creatives through documented TikTok API routes.
Use Crawlora TikTok endpoints for profiles, videos, mobile search and feeds, comments, hashtags, sounds, LIVE discovery, trends, and Top Ads.
Endpoint families
6
Documented params
258
Examples
81
Live catalog snapshot
Active endpoints
81
Methods
GET
Required params
133
Schema refs
81
{
"platform": "TikTok",
"endpoint": "tiktok-search",
"method": "GET",
"path": "/tiktok/search",
"auth": "apiKey"
}Related use cases
Free tools
Use cases
Use Crawlora TikTok endpoints for profiles, videos, mobile search and feeds, comments, hashtags, sounds, LIVE discovery, trends, and Top Ads.
Use TikTok endpoints to turn creator profile analysis into repeatable API requests with documented inputs and JSON responses.
Use TikTok endpoints to turn mobile feed and video discovery into repeatable API requests with documented inputs and JSON responses.
Use TikTok endpoints to turn sound, live, and ad creative research into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live TikTok endpoint catalog — 81 endpoints, 258 documented request parameters, and 81 published response schemas — the same catalog Docs and Playground run against.
81 documented TikTok endpoints, grouped into 14 request families — Mobile, Top Ads and Creative Center, plus 11 more.
258 request parameters are documented across those TikTok endpoints, 133 of them required — the full input contract is public before you write any integration code.
81 of the 81 TikTok endpoints ship a recorded example response, and 81 carry a documented response schema — you can code against the real JSON before the first request.
TikTok endpoints document their error responses (400, 404, 429, 500 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
67 hosted MCP tools back the TikTok endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
/tiktok/mobile/search
/tiktok/top-ads/list
/tiktok/creative-center/filters
/tiktok/search
/tiktok/category
/tiktok/comments
Featured endpoints
/tiktok/searchSearches TikTok videos for `keyword`. `cursor` defaults to 0 and `count` defaults to 20, capped at 50. The response has the matching video items, a `cursor` and `has_more` for paging. An empty, blocked or malformed result from TikTok returns an upstream error.
Response notes
- Uses the configured TikTok web signer sidecar when `TikTokAPIHost` points to a compatible signer. - Returns upstream errors when TikTok serves an empty, blocked, or malformed API response.
Sampled 14 Oct 2026: 20 items, 3 fields filled in every item.
MCP tool tiktok_search
/tiktok/profile/{handler}Returns a public TikTok profile by `handler`, the username without the leading `@`. The `user` object has the id, `uniqueId`, nickname, signature, verified and private flags, region, language, avatar, bio link and `secUid`; `stats` has follower, following, heart, video and friend counts. A missing, deleted or banned handle returns 404.
Sampled 14 Oct 2026: 22 of 23 fields returned with a value. user.createTime: 1,689,461,786; user.avatarLarger: p19-common-sign.tiktokcdn-us.com.
MCP tool tiktok_profile
/tiktok/top-ads/listReturns high-performing auction ads from TikTok Creative Center. The service defaults `period` to 30, `page` to 1, `limit` to 20, and `order_by` to `for_you`. Use `/tiktok/top-ads/filters` for dynamic enum values and static enums for order, duration, likes, and ad format.
Response notes
- Nonzero TikTok upstream response codes are returned as upstream errors. - Signed video and image URLs are passed through as returned by TikTok. - Filter enums for `country_code`, `industry`, `objective`, `ad_language`, `pattern_label`, and `period` come from `/api/v1/tiktok/top-ads/filters`. - Complete enum values for static list filters and the latest verified dynamic upstream snapshot are listed in `docs/tiktok-top-ads-enums.md`.
Sampled 14 Oct 2026: 1 item, 10 fields filled in every item. favorite: true in 0 of 1; is_search: true in 1 of 1.
MCP tool tiktok_top_ads_list
/tiktok/top-ads/detailReturns detail for one TikTok Creative Center Top Ads material. Use `material_id`; the upstream does not accept `id` or `materialId`.
Response notes
- Missing `material_id` returns an invalid-params error. - Nonzero TikTok upstream response codes are returned as upstream errors.
Sampled 14 Oct 2026: 20 of 20 fields returned with a value. data.comment: 21; data.favorite: false.
MCP tool tiktok_top_ads_detail
/tiktok/top-ads/analysisReturns the detail-page interactive time analysis chart and percentile for a Top Ads material. Metric values are `retain_ctr` (CTR), `retain_cvr` (CVR), `click_cnt` (Clicks), `convert_cnt` (Conversion), and `play_retain_cnt` (Remain).
Response notes
- The chart points come from TikTok's public `/top_ads/keyframe` endpoint. - The `percentile` value comes from TikTok's public `/top_ads/percentile` endpoint and uses the matching percentile metric for the requested tab. - Nonzero TikTok upstream response codes are returned as upstream errors. - Complete enum values for `metric` and `period_type` are listed in `docs/tiktok-top-ads-enums.md`.
Sampled 14 Oct 2026: 18 items, 2 fields filled in every item. second: 0 to 17, median 8; value: 0 to 1, median 0.09.
MCP tool tiktok_top_ads_analysis
/tiktok/post/{id}Returns TikTok's detail record for one video by video id. `itemInfo.itemStruct` holds the video's description, the author's profile and the author's statistics (such as followers, following and hearts) along with the rest of TikTok's video object; `shareMeta` holds the share title and description.
Sampled 14 Oct 2026: 4 of 9 fields returned with a value. extra.now: 1,791,911,830,000.
MCP tool tiktok_post
Related APIs
Social & Creator Platforms
Build creator intelligence, video research, transcript, and audience-comment workflows without maintaining YouTube scrapers.
Social & Creator Platforms
Turn Twitch's public channel, stream, clip, and team data into structured JSON — live status and viewer counts, top games, clips, VODs, and team rosters — as normalized JSON. Credential-free.
Social & Creator Platforms
Turn Instagram public data into structured inputs for social listening and creator research.
How to scrape TikTok
TikTok's app exposes several distinct public surfaces. Crawlora documents separate routes for web profiles and videos, mobile feed and search results, comment threads, sounds, hashtags, LIVE discovery, and Top Ads data.
Start with a profile, video, keyword, hashtag, sound, LIVE stream, or public ad creative; the mobile feed has its own endpoint.
Pass a username, video or sound ID, keyword, or hashtag to its documented route; use the returned cursor on mobile endpoints that expose one.
Get the endpoint's available video statistics, author details, comments, sounds, hashtags, or LIVE metadata as structured JSON.
Store identifiers and cursors to revisit creator activity, hashtag posts, sound charts, and public trend signals over time.
On 2026-10-30 /tiktok/comments with count=10 returned 19 comments plus has_more 1 and a cursor of 20, so page by cursor and count rows received. /tiktok/category returned 21 categories, and creative-center hashtags for US over 7 days returned only 3 hashtags.
Client libraries
Install the dedicated TikTok client for your language. Each package covers the TikTok endpoints on this page and calls Crawlora's hosted API with your API key.
npm install @crawlora-org/tiktoknpmpip install crawlora-tiktokPyPIgo get github.com/Crawlora-org/crawlora-tiktokpkg.go.devgem install crawlora-tiktokRubyGemsnet.crawlora:crawlora-tiktokMaven Centralcomposer require crawlora/tiktokPackagistcargo add crawlora-tiktokcrates.ioAgent skills
Install a Crawlora agent skill and your agent can pull TikTok data as JSON through the documented API, without writing a scraper. These skills cover TikTok:
Research public TikTok profiles, videos, comments, hashtags, search results, trending feeds, and Creative Center signals through Crawlora. Use for…
npx skills add github.com/Crawlora-org/crawlora-skills --skill tiktok-researchBuild evidence-backed TikTok trend briefs from current feeds, Creative Center rankings, hashtag data, and Explore categories through Crawlora. Use…
npx skills add github.com/Crawlora-org/crawlora-skills --skill tiktok-trend-researchResearch TikTok Creative Center Top Ads by brand, market, industry, and objective through Crawlora. Use for competitor-ad comparisons, creative…
npx skills add github.com/Crawlora-org/crawlora-skills --skill tiktok-ad-researchFAQ
Choose a documented route for a public profile, video, hashtag, sound, keyword search, LIVE discovery, or Top Ads example. The mobile routes also expose a For You feed, search suggestions, comments and replies, place search, and trend categories. Each endpoint specifies its own required IDs and pagination fields.
Yes. The catalog includes video lookups, the mobile feed and search results, top-level comments for a video, and replies to a selected comment. Response fields and continuation cursors vary by route; persistent upstream throttling is returned as an error rather than a fabricated empty result.
The mobile feed documentation specifies an x-api-key and says Crawlora signs the upstream mobile request without a customer device or TikTok account. Other mobile routes have their own parameters and response limits in their endpoint pages. These routes describe public surfaces and do not grant access to private accounts.
Yes. The mobile place routes let you search a venue by name, then page every video tagged at its place ID, and a separate route returns a video's captions translated into 16 languages where TikTok has captions. Use the string place ID, and page until the response says there is no more rather than trusting a place's video count.
Collecting publicly accessible video and profile data is generally permissible if you respect TikTok's terms of use, robots directives, rate limits, and applicable law. This is for public data you're authorized to collect.
TikTok's official Research API is restricted to approved academic institutions and nonprofits — commercial applications are typically rejected, and there's no free, general-purpose commercial access to TikTok's public data through official channels. Crawlora's TikTok endpoints read public profile, video, hashtag, and trend data directly, with no research-eligibility application.