Crawlora Docs
Research public video, hashtag, creator, music, and Top Ads creative signals for trend analysis and reporting.
Research public video, hashtag, creator, music, and Top Ads creative signals for trend analysis and reporting.
Only endpoints that exist in the generated endpoint metadata are linked here. Missing optional endpoints are intentionally omitted.
/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.
/tiktok/search/hashtagSearches 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.
/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.
/tiktok/commentsReturns 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.
/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.
| Field | Notes |
|---|---|
| keyword | Workflow field; map to exact endpoint response fields from endpoint docs. |
| hashtag | Workflow field; map to exact endpoint response fields from endpoint docs. |
| video_id | Workflow field; map to exact endpoint response fields from endpoint docs. |
| creator | Workflow field; map to exact endpoint response fields from endpoint docs. |
| music | Workflow field; map to exact endpoint response fields from endpoint docs. |
| ad_material_id | Workflow field; map to exact endpoint response fields from endpoint docs. |
| views | Workflow field; map to exact endpoint response fields from endpoint docs. |
| likes | Workflow field; map to exact endpoint response fields from endpoint docs. |
| comments | Workflow field; map to exact endpoint response fields from endpoint docs. |
| posted_at | Workflow field; map to exact endpoint response fields from endpoint docs. |
| score | Workflow field; map to exact endpoint response fields from endpoint docs. |
This example uses the real Search TikTok videos endpoint. Exact request fields come from the endpoint metadata.
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/tiktok/search?keyword=dance&count=10" \
-H "x-api-key: $CRAWLORA_API_KEY"Use endpoint detail pages for exact response schemas. This recipe does not invent response fields.
{
"code": 200,
"msg": "OK",
"data": {
"type": 1,
"data": [
{
"item": {
"id": "7627480436649757959"
}
}
],
"cursor": 20,
"has_more": 1,
"status_code": 0
}
}Store snapshots by video ID and timestamp so trend scores can be recalculated as engagement changes.
Estimate usage by multiplying requests by endpoint credit cost. The table below only shows real credit costs available from the billing constants.
| Endpoint | Credit cost | Docs |
|---|---|---|
| Search TikTok videos | 8 credits/request | /docs/tiktok/tiktok-search |
| Search TikTok hashtags | 8 credits/request | /docs/tiktok/tiktok-search-hashtag |
| Retrieve TikTok video details | 8 credits/request | /docs/tiktok/tiktok-post |
| Retrieve TikTok video comments | 8 credits/request | /docs/tiktok/tiktok-video-comments |
| Retrieve TikTok Top Ads | 8 credits/request | /docs/tiktok/tiktok-top-ads-list |
Crawlora is designed for responsible structured public web data workflows. Customers are responsible for using Crawlora in compliance with applicable laws, third-party rights, target-platform rules, and Crawlora terms.
Read Crawlora termsUse this recipe for workflow shape, then rely on endpoint reference pages for exact paths, request schemas, response schemas, and credit costs.