Managed gateway · LeanPool

Recommended creator terms

Breakout search terms and content-gap topics recommended for creators.

GETapi.tikultra.com/v1/creator/recommended-termsHeavy · 10 credits

Upstream/tiktok/v1/creator/search_insights/recommended_terms/Every plan

Parameters

Name	Type	Description
`category`	string	Optional creator category filter. e.g. tech_electronics
`region`	string	Two-letter country code for egress and storefront. e.g. US
`city`	string	A city in that region. See the supported cities list. e.g. miami

Pricing

Plan	Per call	Per 1,000 calls
Starter	10 credits	$1.16
Growth	10 credits	$0.79
Scale	10 credits	$0.58

Response fields

Field	Type	Description
`status_code`	integer	Upstream TikTok mobile status code (0 indicates success).
`region`	string	Two-letter ISO 3166-1 country code associated with the item or context.
`city`	string	City-level egress or location identifier.
`category`	string	Decoded category value.
`terms`	object[]	List of terms objects.
`terms[].topic_id`	string	Unique topic identifier.
`terms[].keyword`	string	Decoded keyword value.
`terms[].growth_7d_pct`	number	Decoded growth 7d pct value.
`terms[].content_gap`	boolean	Whether content gap is enabled or true.
`terms[].search_volume_index`	integer	Decoded search volume index value.
`log_pb`	object	Upstream request trace envelope from the mobile gateway.
`log_pb.impr_id`	string	Upstream TikTok impression / trace identifier.

Responses

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining. Errors return a JSON body with a stable code and cost 0 credits. Error codes

import os
from tikultra import TikUltra

with TikUltra(api_key=os.environ["TIKULTRA_KEY"]) as client:
    res = client.request("GET", "/v1/creator/recommended-terms")
    print(res.credits_cost, res.data)

{
  "status_code": 0,
  "region": "US",
  "city": "miami",
  "category": "tech_electronics",
  "terms": [
    {
      "topic_id": "7420998877665544332",
      "keyword": "low profile mechanical keyboard",
      "growth_7d_pct": 148.5,
      "content_gap": true,
      "search_volume_index": 94200
    },
    {
      "topic_id": "7420998877665544339",
      "keyword": "hall effect magnetic switches",
      "growth_7d_pct": 212,
      "content_gap": true,
      "search_volume_index": 71800
    },
    {
      "topic_id": "7420998877665544344",
      "keyword": "macbook desk dock setup 2026",
      "growth_7d_pct": 89.4,
      "content_gap": false,
      "search_volume_index": 118400
    }
  ],
  "log_pb": {
    "impr_id": "202611120200419F8E7D6C5B4A3210"
  }
}

Try it in the playground Full reference in the docs

More in Feeds, search & Tako AI

GET/v1/feed/persona-fypExclusivePersona For You feed10 cr GET/v1/feed/persona-fyp/citiesSupported persona citiesFree GET/v1/feedFeeds5 cr GET/v1/feed/storiesStories feed5 cr GET/v1/feed/landscapeLandscape feed5 cr GET/v1/searchSearch5 cr GET/v1/search/suggestionsSearch suggestions5 cr POST/v1/vision/ecom-searchExclusiveVision search25 cr POST/v1/tako/askExclusiveTako ask25 cr POST/v1/tako/chatTako chat25 cr GET/v1/tako/sugTako suggestions5 cr GET/v1/tako/conversationGrowth+Tako conversation10 cr GET/v1/tako/inboxGrowth+Tako inbox10 cr GET/v1/tako/memoryGrowth+Tako memory10 cr GET/v1/creator/search-insightsSearch insights25 cr GET/v1/creator/search-insights/detailSearch insight detail25 cr GET/v1/creator/search-insights/trendSearch insight trend25 cr GET/v1/creator/search-insights/videosSearch insight videos25 cr GET/v1/douyin/hotDouyin hot list10 cr GET/v1/douyin/searchDouyin hot search10 cr GET/v1/douyin/brandDouyin brand board10 cr GET/v1/douyin/musicDouyin music board10 cr

Ready to build?

Start with 2,500 free credits and test every public endpoint, then pick a plan.

Get an API key See pricing