Docs menu

Crawlora Docs

Build a TikTok Trend Research Workflow

Research public video, hashtag, creator, and music signals for trend analysis and reporting.

Overview

Research public video, hashtag, creator, and music signals for trend analysis and reporting.

What you will build

  • Define niche, hashtag, or creator list
  • Pull public trend data
  • Normalize video, creator, and music fields
  • Score trend signals
  • Export or report
  • Refresh periodically

APIs used

Only endpoints that exist in the generated endpoint metadata are linked here. Missing optional endpoints are intentionally omitted.

GETTikTokapiKey8 credits/request

Search TikTok videos

/tiktok/search

Searches TikTok videos by keyword with cursor-based pagination.

GETTikTokapiKey8 credits/request

Retrieve TikTok video details

/tiktok/post/{id}

Returns the TikTok video detail payload for a video id.

Data model

FieldNotes
keywordWorkflow field; map to exact endpoint response fields from endpoint docs.
hashtagWorkflow field; map to exact endpoint response fields from endpoint docs.
video_idWorkflow field; map to exact endpoint response fields from endpoint docs.
creatorWorkflow field; map to exact endpoint response fields from endpoint docs.
musicWorkflow field; map to exact endpoint response fields from endpoint docs.
viewsWorkflow field; map to exact endpoint response fields from endpoint docs.
likesWorkflow field; map to exact endpoint response fields from endpoint docs.
commentsWorkflow field; map to exact endpoint response fields from endpoint docs.
posted_atWorkflow field; map to exact endpoint response fields from endpoint docs.
scoreWorkflow field; map to exact endpoint response fields from endpoint docs.

Step-by-step workflow

  1. 1.Define niche, hashtag, or creator list
  2. 2.Pull public trend data
  3. 3.Normalize video, creator, and music fields
  4. 4.Score trend signals
  5. 5.Export or report
  6. 6.Refresh periodically

Example request

This example uses the real Search TikTok videos endpoint. Exact request fields come from the endpoint metadata.

Recipe request

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"

Example response

Use endpoint detail pages for exact response schemas. This recipe does not invent response fields.

Generated example response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "type": 1,
    "data": [
      {
        "item": {
          "id": "7627480436649757959"
        }
      }
    ],
    "cursor": 20,
    "has_more": 1,
    "status_code": 0
  }
}

Storage/output suggestion

Store snapshots by video ID and timestamp so trend scores can be recalculated as engagement changes.

Error handling

  • Validate required inputs before calling Crawlora
  • Retry 429 and temporary 5xx responses with capped backoff
  • Log endpoint, input, timestamp, and request ID when present
  • Treat empty results as a state your application can handle
  • Open /docs/errors for production retry guidance

Rate-limit and credit planning

Estimate usage by multiplying requests by endpoint credit cost. The table below only shows real credit costs available from the billing constants.

EndpointCredit costDocs
Search TikTok videos8 credits/request/docs/TikTok/tiktok-search
Retrieve TikTok video details8 credits/request/docs/TikTok/tiktok-post

Production checklist

  • Keep API keys server-side
  • Use request timeouts
  • Back off on rate limits
  • Store raw responses or source IDs for auditability
  • Monitor credits and failures
  • Avoid unnecessary refreshes
  • Review responsible-use requirements

Responsible public web data workflows

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 terms

Related APIs and pages

Build this workflow with real endpoint docs

Use this recipe for workflow shape, then rely on endpoint reference pages for exact paths, request schemas, response schemas, and credit costs.