API reference / Connected sessions / Warm session for niche

Warm session for niche

Calibrate a connected session’s For You feed toward a topic.

POSTapi.tikultra.com/v1/account/warm/nichePremium · 25 credits
Upstream
/aweme/v1/feed//aweme/v1/general/search/single/
Access
Growth and up
Runs on
FullPool
Billing
Failed calls are free

Authorization

x-api-keyheader · stringrequired

Your API key. Create one in API keys.

Body

Send JSON with content-type: application/json.

account_idstringrequired

A connected account, from /dash/sessions or POST /v1/account/import. For example acc_7Hq2.

nichestringrequired

Topic or keyword cluster to calibrate toward. For example mechanical keyboards.

duration_secinteger

Warming window in seconds. For example 45.

Response

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

Errors

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

Accounts you own only. Connected sessions are for accounts you own or are authorized to operate. Available on Growth and Scale.