Connected session · FullPool

Import session

Bind a session you own to a dedicated mobile context.

POSTapi.tikultra.com/v1/account/importPremium · 25 credits

Upstream/passport/account/info/v2//aweme/v1/user/profile/self/Growth and up

Parameters

Name	Type	Description
`session_id`required	string	The sessionid or sid_tt value exported from your device. e.g. 7f8e9d0c1b2a3f4e5d6c7b8a9f0e1d2c
`cookies`	object	Optional full cookie map from your device.
`device_id`	string	Bind to a device you already provisioned. Omit to provision one.
`os`	string	android or ios. e.g. android
`app_flavour`	string	Which app to run as. e.g. tiktok
`app_version`	string	A release of that app. Defaults to the current default for (os, app_flavour). e.g. 47.6.3
`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	25 credits	$2.90
Growth	25 credits	$1.98
Scale	25 credits	$1.45

Connected sessions run on FullPool and are for accounts you own or are authorized to operate. Growth and up.

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

curl -X POST https://api.tikultra.com/v1/account/import \
  -H "x-api-key: $TIKULTRA_KEY" \
  -H "content-type: application/json" \
  -d '{"session_id":"7f8e9d0c1b2a3f4e5d6c7b8a9f0e1d2c","cookies":{"sessionid":"7f8e9d0c1b2a3f4e5d6c7b8a9f0e1d2c","tt-target-idc":"useast5"},"os":"android","app_flavour":"tiktok","app_version":"47.6.3","region":"US","city":"miami"}'

{
  "account_id": "acc_7Hq2",
  "status": "connected",
  "health": "healthy",
  "uid": "6970000000000000001",
  "sec_uid": "MS4wLjABAAAAq8V3xLm2pR9wQ8mN4vK1zH7tB2yX",
  "username": "acme",
  "nickname": "Acme Studio",
  "device": {
    "device_id": "7392011847562901234",
    "os": "android",
    "app_flavour": "tiktok",
    "app_version": "47.6.3",
    "region": "US",
    "city": "miami",
    "pool": "FullPool"
  }
}

Try it in the playground Full reference in the docs

More in Connected sessions

Ready to build?

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

Get an API key See pricing