API reference / Feeds, search & Tako AI / Recommended creator terms

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/
Access: Every plan
Runs on: LeanPool · android · tiktok · 47.5.41
Client: os, app_flavour, app_version overrides
Billing: Failed calls are free

Authorization & parameters

x-api-keyheader · stringrequired

Your API key. Create one in API keys.

Query parameters

categorystring

Optional creator category filter. For example tech_electronics.

regionstring

Two-letter country code for egress and storefront. For example US.

citystring

A city in that region. See the supported cities list. For example miami.

Client and egress

Optional. Leave them out to run as android · tiktok · 47.5.41 from the default LeanPool context. See Clients and versions.

osstring

android or ios. For example android.

app_flavourstring

Run as tiktok, lite, lite_coin, pro, studio, shop, tv, douyin. For example tiktok.

app_versionstring

A release of that app. Defaults to the current default for (os, app_flavour). For example 47.5.41.

regionstring

Two-letter country code for egress. For example US.

citystring

A supported city in that region. For example miami.

Response

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining.

Response fields

Key top-level and nested fields decoded from the mobile upstream payload:

status_codeinteger

Upstream TikTok mobile status code (0 indicates success).

regionstring

Two-letter ISO 3166-1 country code associated with the item or context.

citystring

City-level egress or location identifier.

categorystring

Decoded category value.

termsobject[]

List of terms objects.

terms[].topic_idstring

Unique topic identifier.

terms[].keywordstring

Decoded keyword value.

terms[].growth_7d_pctnumber

Decoded growth 7d pct value.

terms[].content_gapboolean

Whether content gap is enabled or true.

terms[].search_volume_indexinteger

Decoded search volume index value.

log_pbobject

Upstream request trace envelope from the mobile gateway.

log_pb.impr_idstring

Upstream TikTok impression / trace identifier.

Errors

Errors return a JSON body with a stable code and cost 0 credits. See Errors and retries.

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" } }