API Reference
Use Crawlora TikTok endpoints for profile, video, hashtag, music, search, trend, and Top Ads creative intelligence. 25 endpoints documented below.
curl "https://api.crawlora.net/api/v1/tiktok/search?count=10&keyword=dance" \
-H "x-api-key: $CRAWLORA_API_KEY"TikTok's data is rendered for the app, not for APIs. Crawlora's TikTok endpoints return public profile, video, hashtag, and trending data as structured JSON.
A creator profile, a single video, a hashtag/challenge, or the trending feed.
Pass the username, video ID, or hashtag to Crawlora's TikTok endpoint.
Receive follower counts, video views/likes/shares, captions, sounds, and hashtags as clean JSON.
Re-run to monitor trending content, creator growth, and hashtag momentum.
/tiktok/categoryapiKey8 credits/requestReturns the content categories shown on TikTok's Explore page. Each entry has the category name and its numeric type code. Takes no parameters.
Takes no parameters.
Sampled 14 Oct 2026: 21 items. Filled in every item: name, type. In the sample: type: 100 to 120, median 110.
/tiktok/commentsapiKey8 credits/requestReturns the top-level comments on a TikTok video, by the video id from its URL (`aweme_id`). Results are paged by cursor: pass the `cursor` from one response to get the next page, and read `has_more` to see whether more remain. The response also carries the total comment count.
Required: aweme_id. Optional: cursor.
Sampled 14 Oct 2026: 18 items. Filled in every item: allow_download_photo, author_pin, aweme_id, cid, collect_stat, comment_language, create_time, digg_count and 21 more. Not in every item: image_list (3), label_list (2), reply_comment (1), label_text (1), label_type (1), cmt_sticker_struct (1), comment_post_item_ids (0), text_extra (0) and 2 more. In the sample: create_time: 2026-04-19 to 2026-10-10; digg_count: 0 to 10,950, median 3; allow_download_photo: true in 14 of 18; image_list: median 1 entry; author_pin: true in 0 of 18; is_author_digged: true in 1 of 18; is_comment_translatable: true in 18 of 18; is_high_purchase_intent: true in 3 of 18.
/tiktok/creative-center/hashtagsapiKey8 credits/requestReturns TikTok Creative Center's ranked trending hashtags for a country and period. TikTok gates this endpoint's full result set behind a logged-in TikTok One account: an anonymous request always receives at most 3 hashtags regardless of country or period.
Required: country_code. Optional: period (2 allowed values: 7, 30).
Sampled 14 Oct 2026: 3 items. Filled in every item: hashtag_id, hashtag_name, rank, publish_count, video_views, popularity_curve, top_creators. Not in every item: industry_ids (2). In the sample: rank: 1 to 3, median 2; popularity_curve: median 7 entries; publish_count: 23,651 to 107,135, median 27,747; video_views: 18,410,403 to 213,063,413, median 29,754,975; top_creators: median 3 entries.
/tiktok/creative-center/videosapiKey8 credits/requestReturns TikTok Creative Center's ranked trending videos for a country, period, and sort order. TikTok reports the true result-set size (see total_count/page_count in the response) but gates access to it behind a logged-in TikTok One account: an anonymous request always receives page 1 (4 videos) regardless of sort order or period. Country coverage is uneven: US, JP, ID, VN, and TH reliably return populated results; other countries have been observed to return an empty videos array (a genuine no-data response, not an error).
Required: country_code. Optional: period (2 allowed values: 7, 30), sort_by (3 allowed values: views, engagement, six_second_views), content_label_id, organic_only.
Sampled 14 Oct 2026: 4 items. Filled in every item: item_id, title, video_url, cover_url, content_type, create_time, author_id, author_handle and 12 more. Not in every item: content_tags (1). In the sample: create_time: 2026-02-19 to 2026-09-30; author_follower_count: 64,307 to 6,968,672, median 82,122; video_url: v16m-default.tiktokcdn-us.com; title: median 244 characters; content_tags: median 1 entry; cover_url: p19-common-sign.tiktokcdn-us.com and 1 other host; author_avatar_url: p19-common-sign.tiktokcdn-us.com and 1 other host; video_views: 20,433,757 to 79,724,346, median 21,833,783.
/tiktok/explore/{id}apiKey8 credits/requestReturns the TikTok explore feed for a category, given its category type `id` from the category endpoint. The response has `itemList` with the videos, `hasMore` and a `cursor`. A feed that comes back empty is reported as an upstream error, not as an empty list.
Required: id.
Sampled 14 Oct 2026: 30 items. Filled in every item: CategoryType, IsHDBitrate, ShowAIGC, author, authorStats, authorStatsV2, collected, contents and 23 more. Not in every item: anchors (13), challenges (28), diversificationId (28), duetEnabled (27), stickersOnItem (6), stitchEnabled (27), textExtra (28), AIGCDescription (0) and 1 more. In the sample: CategoryType: 101 to 120, median 113; IsHDBitrate: true in 0 of 30; anchors: median 1 entry; ShowAIGC: true in 30 of 30; challenges: median 5 entries; collected: true in 0 of 30; contents: median 1 entry; createTime: 1,789,448,270 to 1,791,614,805, median 1,790,800,986.
/tiktok/hashtag/{name}apiKey8 credits/requestReturns the details of a TikTok hashtag page by `name`, for example `christmas`. The response carries `challengeInfo` with the hashtag's metadata, such as cover images, and `shareMeta` with the share title and description. The hashtag id found here feeds `tiktok-challenge-list`.
Required: name.
Sampled 14 Oct 2026: 11 fields returned with a value, 2 empty (extra.fatal_item_ids, status_msg). In the sample: extra.now: 1,791,911,829,000; statusCode: 0.
/tiktok/hashtagsapiKey8 credits/requestLists the videos posted under a TikTok hashtag, identified by the hashtag `id` from the hashtag detail endpoint. `cursor` defaults to 0. The response has `itemList`, `hasMore` and a `cursor`; pass that cursor back to fetch the next page.
Required: id. Optional: cursor.
Sampled 14 Oct 2026: 30 items. Filled in every item: CategoryType, IsHDBitrate, ShowAIGC, author, authorStats, authorStatsV2, collected, contents and 24 more. Not in every item: challenges (29), enterMdpPV (16), textExtra (29), diversificationId (22), duetEnabled (26), playlistId (6), AIGCDescription (0), backendSourceEventTracking (0). In the sample: CategoryType: 101 to 120, median 111; IsHDBitrate: true in 0 of 30; desc: median 102 characters; challenges: median 5 entries; ShowAIGC: true in 24 of 30; collected: true in 0 of 30; contents: median 1 entry; createTime: 1,637,636,090 to 1,791,807,991, median 1,639,523,603.
/tiktok/popular-trend/country-industry-metaapiKey8 credits/requestLists the country and industry filter values used by the TikTok Creative Center popular-trend endpoints. Countries have an `id` such as `AR` and a name; industries have a numeric `id` and a name such as Apparel & Accessories. A maintained fallback list is returned if TikTok's own metadata is unavailable.
Takes no parameters.
Sampled 14 Oct 2026: 71 items. Filled in every item: id, value.
/tiktok/post/{id}apiKey8 credits/requestReturns 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.
Required: id.
Sampled 14 Oct 2026: 4 fields returned with a value, 5 empty (extra.fatal_item_ids, itemInfo, shareMeta.desc, shareMeta.title, status_msg). In the sample: extra.now: 1,791,911,830,000.
/tiktok/postsapiKey8 credits/requestLists posts from a TikTok profile identified by `secUid`. `sort_type` is `0` latest (default), `1` popular or `2` oldest. `cursor` defaults to 0. The response has `itemList`, `hasMore` and a `cursor` to pass back to fetch the next page.
Required: secUid. Optional: cursor, sort_type (3 allowed values: 0, 1, 2).
Sampled 14 Oct 2026: 35 items. Filled in every item: CategoryType, IsHDBitrate, ShowAIGC, author, authorStats, authorStatsV2, collected, createTime and 22 more. Not in every item: contents (31), desc (31), duetEnabled (25), penaltyContext (25), stitchEnabled (25), imagePost (10), titleLanguage (10), titleTranslatable (10) and 2 more. In the sample: CategoryType: 103 to 120, median 120; IsHDBitrate: true in 0 of 35; contents: median 1 entry; ShowAIGC: true in 11 of 35; collected: true in 0 of 35; createTime: 1,789,107,622 to 1,791,905,298, median 1,790,356,493; digged: true in 0 of 35; duetEnabled: true in 25 of 25.
/tiktok/profile/{handler}apiKey8 credits/requestReturns 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.
Required: handler.
Sampled 14 Oct 2026: 22 fields returned with a value, 1 empty (user.region). In the sample: user.createTime: 1,689,461,786; user.avatarLarger: p19-common-sign.tiktokcdn-us.com; user.verified: true; user.privateAccount: false; user.secret: false; user.ttSeller: false; user.isOrganization: 1; stats.followerCount: 4,000,000.
/tiktok/searchapiKey8 credits/requestSearches 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.
Required: keyword. Optional: cursor, count.
Sampled 14 Oct 2026: 20 items. Filled in every item: common, item, type.
/tiktok/search/hashtagapiKey8 credits/requestSearches TikTok hashtags (challenges) for `keyword`. `cursor` defaults to 0 and `count` defaults to 20, capped at 50. The response has `challenge_list` with each hashtag's name and id, plus a `cursor` and `has_more` for paging. An empty, blocked or malformed result returns an upstream error.
Required: keyword. Optional: cursor, count.
Sampled 14 Oct 2026: 3 items. Filled in every item: id, title. Not in every item: coverLarger (0), coverMedium (0), coverThumb (0), desc (0), profileLarger (0), profileMedium (0), profileThumb (0).
/tiktok/search/userapiKey8 credits/requestSearches TikTok users for `keyword`, with `cursor` (default 0) for paging. The response has `user_list` with the matching accounts, plus a `cursor` and `has_more` to continue. Pass the returned `cursor` back to fetch the next page.
Required: keyword. Optional: cursor.
Sampled 14 Oct 2026: 10 items. Filled in every item: user_info. Not in every item: challenges (0), effects (0), items (0), mix_list (0), musics (0), position (0), uniqid_position (0).
/tiktok/top-ads/analysisapiKey8 credits/requestReturns 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).
Required: material_id. Optional: metric (5 allowed values: retain_ctr, retain_cvr, click_cnt, convert_cnt, play_retain_cnt), period_type (3 allowed values: 7, 30, 180).
Sampled 14 Oct 2026: 18 items. Filled in every item: second, value. In the sample: second: 0 to 17, median 8; value: 0 to 1, median 0.09.
/tiktok/top-ads/detailapiKey8 credits/requestReturns detail for one TikTok Creative Center Top Ads material. Use `material_id`; the upstream does not accept `id` or `materialId`.
Required: material_id.
Sampled 14 Oct 2026: 20 fields returned with a value. In the sample: data.comment: 21; data.favorite: false; data.objectives: 1 entry; data.cost: 1; data.ctr: 0.14; data.like: 268; data.share: 12.
/tiktok/top-ads/filtersapiKey8 credits/requestReturns filter metadata for TikTok Creative Center Top Ads. Dynamic values come from TikTok; static UI enums are included for `order_by`, `duration`, `like`, and `ad_format`.
Takes no parameters.
Sampled 14 Oct 2026: 258 items. Filled in every item: id, value, label. Not in every item: parent_id (237).
/tiktok/top-ads/listapiKey8 credits/requestReturns 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.
Optional: period (3 allowed values: 7, 30, 180), page, limit, order_by (7 allowed values: for_you, impression, ctr, play_2s_rate, play_6s_rate, cvr, like), country_code, keyword, industry, objective, ad_language, pattern_label, duration (6 allowed values: time-2, time-3, time-4, time-5, time-6, time-7), like (5 allowed values: 1, 2, 3, 4, 5), ad_format (2 allowed values: 1, 2).
Sampled 14 Oct 2026: 1 item. Filled in every item: ad_title, cost, ctr, favorite, id, industry_key, is_search, like and 2 more. In the sample: favorite: true in 0 of 1; is_search: true in 1 of 1.
/tiktok/top-ads/location-infoapiKey8 credits/requestReturns TikTok's inferred initial country and industry targeting context for Top Ads. Use it when you need starting targeting values; use the locations, filters, and list endpoints to choose criteria and retrieve ads.
Optional: module.
Sampled 14 Oct 2026: 6 fields returned with a value, 2 empty (data.first_industry, data.second_industry). In the sample: data.l1_industry: 0; data.initial_country: 1 entry; data.l2_industry: 0.
/tiktok/top-ads/locationsapiKey8 credits/requestLists the country filters offered by TikTok Creative Center Top Ads. Each country has an `id` such as `US`, a `value` (the country name), a `label` and a `has_conversion` flag. Takes no parameters.
Takes no parameters.
Sampled 14 Oct 2026: 73 items. Filled in every item: id, value, label.
/tiktok/top-ads/recommendapiKey8 credits/requestLists Top Ads materials that TikTok Creative Center recommends as related to the ad with `material_id`. `page` starts at 1; `limit` defaults to 20 and is capped at 100. Each ad has its title, brand, likes, comments, shares, CTR, objectives and video info. The list can be empty for a valid id.
Required: material_id. Optional: page, limit.
Sampled 14 Oct 2026: 3 fields returned with a value, 1 empty (data.materials).
/tiktok/top-ads/safetyapiKey8 credits/requestReturns the Creative Center safety configuration flags for search: `top_ads_search`, `keyword_search`, `hashtag_search`, `creator_search`, `sound_search` and `cc_banner_key`. It carries feature flags only, not ad materials. Takes no parameters.
Takes no parameters.
Sampled 14 Oct 2026: 8 fields returned with a value, 1 empty (data.cc_banner_key). In the sample: data.creator_search: 0; data.hashtag_search: 0; data.keyword_search: 0; data.sound_search: 0; data.top_ads_search: 0.
/tiktok/top-ads/spotlightapiKey8 credits/requestLists the Top Ads Spotlight materials that TikTok Creative Center hand-picks. `page` starts at 1; `limit` defaults to 20 and is capped at 100. Each ad has its title, brand, likes, comments, shares, CTR, objectives and video info. `data.pagination` gives the page, size, total and `has_more`.
Optional: page, limit.
Sampled 14 Oct 2026: 5 items. Filled in every item: cost, ctr, favorite, highlight, id, like, video_info. In the sample: cost: 1 to 2, median 2; favorite: true in 0 of 5; highlight: median 218 characters; ctr: 0.13 to 0.21, median 0.15; like: 77 to 36,951, median 5,580.
/tiktok/top-ads/suggestionsapiKey8 credits/requestReturns Top Ads search suggestions from TikTok Creative Center. `count` is the maximum number of suggestions (default 50) and `scenario` picks the suggestion scenario id (default 1). The `query` list can be empty for the default scenario.
Optional: count, scenario.
Sampled 14 Oct 2026: 3 fields returned with a value, 1 empty (data.query).
/tiktok/trendingapiKey8 credits/requestReturns the current TikTok trending feed: `itemList` holds the videos, and `hasMore` and `cursor` describe paging. The response also has a `trendingTopics` field. Takes no parameters.
Takes no parameters.
Sampled 14 Oct 2026: 5 items. Filled in every item: CategoryType, IsHDBitrate, ShowAIGC, author, authorStats, authorStatsV2, backendSourceEventTracking, challenges and 27 more. Not in every item: imagePost (1), titleLanguage (1), titleTranslatable (1), diversificationId (4), AIGCDescription (0). In the sample: CategoryType: 100 to 120, median 111; IsHDBitrate: true in 0 of 5; challenges: median 5 entries; ShowAIGC: true in 5 of 5; collected: true in 0 of 5; contents: median 1 entry; createTime: 1,787,227,929 to 1,791,360,827, median 1,788,366,377; digged: true in 0 of 5.
Results from the 7 days to 14 Oct 2026. Current status
| Endpoint | Request | Checks passed | Median response |
|---|---|---|---|
| List TikTok explore categories | GET /tiktok/category | 100% | 1.06 s |
| Retrieve TikTok video comments | GET /tiktok/comments?aweme_id=7369014692247964970&count=10 | 100% | 1.28 s |
| Retrieve TikTok Creative Center trending hashtags | GET /tiktok/creative-center/hashtags?country_code=US&period=7 | 96.5% | 1.55 s |
| Retrieve TikTok Creative Center trending videos | GET /tiktok/creative-center/videos?country_code=US&period=7&sort_by=views | 99.8% | 1.91 s |
| Retrieve the TikTok explore feed for a category | GET /tiktok/explore/120 | 99.9% | 2.06 s |
| Retrieve TikTok hashtag details | GET /tiktok/hashtag/chatgpt | 100% | 0.45 s |
| Retrieve TikTok hashtag posts | GET /tiktok/hashtags?id=3242 | 100% | 4.07 s |
| Retrieve TikTok popular-trend country and industry metadata | GET /tiktok/popular-trend/country-industry-meta | 100% | 0.19 s |
| Retrieve TikTok video details | GET /tiktok/post/7369014692247964970 | 100% | 1.25 s |
| Retrieve posts from a TikTok profile | GET /tiktok/posts?secUid=MS4wLjABAAAAT4vq3vsh9X-Vb_WtV6tz4QWTbKjliTKCiK5DqnJNtQEA2RUveHb7UdnL7xgPK2HB | 99.9% | 3.16 s |
| Retrieve a TikTok profile | GET /tiktok/profile/chatgpt | 100% | 4.25 s |
| Search TikTok videos | GET /tiktok/search?count=10&keyword=dance | 100% | 1.41 s |
| Search TikTok hashtags | GET /tiktok/search/hashtag?count=10&keyword=chatgpt | 100% | 1.15 s |
| Search TikTok users | GET /tiktok/search/user?count=10&keyword=chatgpt | 100% | 1.52 s |
| Retrieve TikTok Top Ads interactive time analysis | GET /tiktok/top-ads/analysis?material_id=7635103915176640520 | 100% | 1.60 s |
| Retrieve TikTok Top Ads detail | GET /tiktok/top-ads/detail?material_id=7635103915176640520 | 100% | 0.76 s |
| Retrieve TikTok Top Ads filters | GET /tiktok/top-ads/filters | 100% | 0.76 s |
| Retrieve TikTok Top Ads | GET /tiktok/top-ads/list?country_code=US | 100% | 0.92 s |
| Retrieve TikTok Top Ads location info | GET /tiktok/top-ads/location-info | 100% | 0.62 s |
| Retrieve TikTok Top Ads locations | GET /tiktok/top-ads/locations | 100% | 0.67 s |
| Retrieve TikTok Top Ads recommendations | GET /tiktok/top-ads/recommend?material_id=7635103915176640520 | 100% | 0.67 s |
| Retrieve TikTok Top Ads safety configuration | GET /tiktok/top-ads/safety | 100% | 0.69 s |
| Retrieve TikTok Top Ads Spotlight | GET /tiktok/top-ads/spotlight | 100% | 0.74 s |
| Retrieve TikTok Top Ads suggestions | GET /tiktok/top-ads/suggestions | 100% | 0.60 s |
| Retrieve TikTok trending posts | GET /tiktok/trending?count=10 | 99.9% | 1.79 s |