API reference / Connected sessions / Warm from seed creators

Warm from seed creators

Calibrate a connected session by visiting seed creator profiles and watching recent posts.

POSTapi.tikultra.com/v1/account/warm/seed-accountsPremium · 25 credits

Upstream: /aweme/v1/user/profile/other//aweme/v1/aweme/post//service/2/app_log/
Access: Growth and up
Runs on: FullPool
Billing: Failed calls are free

Authorization & parameters

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.

usernamesstring[]required

Seed creator @usernames to visit. For example acme,switchlab,deskminimal.

watch_per_profileinteger

Posts to watch per profile. For example 2.

Client and egress

Executes on the dedicated FullPool mobile context and city-level egress bound to account_id. See Connected sessions.

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).

account_idstring

Connected session identifier bound to a dedicated FullPool mobile context.

profiles_visitedstring[]

Decoded profiles visited value.

videos_watchedinteger

Decoded videos watched value.

applog_events_flushedinteger

Decoded applog events flushed value.

warm_tierstring

Interest-graph calibration state (cold, warming, calibrated_warm).

took_msinteger

Gateway execution or signing latency in milliseconds.

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.

import os from tikultra import TikUltra with TikUltra(api_key=os.environ["TIKULTRA_KEY"]) as client: res = client.request( "POST", "/v1/account/warm/seed-accounts", json_body={ "account_id": "acc_7Hq2", "usernames": ["acme", "switchlab", "deskminimal"], "watch_per_profile": 2, }, ) print(res.credits_cost, res.data)

{ "status_code": 0, "account_id": "acc_7Hq2", "profiles_visited": [ "acme", "switchlab", "deskminimal" ], "videos_watched": 6, "applog_events_flushed": 18, "warm_tier": "calibrated_warm", "took_ms": 31400 }