TikTok Creator Search Insights Detail API

Pass a query_id_str from Creator Search Insights and get its popularity trend and searcher demographics.

Use cases

• Understand who searches for a topic.
• Validate content ideas with demand data.
• Target content by age and country.

Request

curl -X POST "https://api.sandbase.ai/v1/api/tiktok/app-v3/creator-search-insights-detail" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query_id_str": "7449584484497752069", "time_range": "past_30_days"}'

Parameters

Example response

Real response for the request above, trimmed to the main fields. User names and long IDs are masked.

{
  "demographics": {
    "age": "25-34",
    "gender": "unknown",
    "location": "United Kingdom"
  },
  "age": [
    {
      "category": "total",
      "popularity": 433427
    },
    {
      "category": "others",
      "popularity": 330399
    },
    {
      "category": "25-34",
      "popularity": 49214
    }
  ],
  "gender": [
    {
      "category": "total",
      "popularity": 493646
    },
    {
      "category": "unknown",
      "popularity": 439331
    },
    {
      "category": "male",
      "popularity": 29608
    }
  ],
  "location": [
    {
      "category": "total",
      "popularity": 401003
    },
    {
      "category": "United Kingdom",
      "popularity": 159147
    },
    {
      "category": "United States of America",
      "popularity": 124437
    }
  ]
}

Notes

• Get query_id_str from the Creator Search Insights API.
• time_range: past_7_days, past_30_days, past_60_days, past_6_months or custom.

Related APIs

• TikTok LIVE Status: Check whether a TikTok LIVE room is currently live by room ID.
• TikTok Creator Search Insights: Get TikTok Creator Search Insights: trending search queries with popularity scores, trend history and video counts, including content-gap topics, by category a…
• TikTok Search: Search TikTok by keyword across videos and users (Top tab).