Connected session · FullPool

LIVE gift & wallet

Send a gift, list room gifts or inspect coin wallet balance on a connected session.

POSTapi.tikultra.com/v1/account/live/gift35 cr

Upstream/webcast/gift/send//webcast/wallet_api/diamond_buy/Growth and up

Parameters

Name	Type	Description
`account_id`required	string	A connected account, from /dash/sessions or POST /v1/account/import. e.g. acc_7Hq2
`room_id`required	string	The numeric LIVE room ID. e.g. 7705861000123456789
`action`required	string	send, list or wallet. e.g. send
`gift_id`	integer	Numeric gift ID when sending. e.g. 5655
`count`	integer	Gift combo count. e.g. 1

Pricing

Plan	Per call	Per 1,000 calls
Starter	35 credits	$4.06
Growth	35 credits	$2.77
Scale	35 credits	$2.04

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

Response fields

Field	Type	Description
`status_code`	integer	Upstream TikTok mobile status code (0 indicates success).
`account_id`	string	Connected session identifier bound to a dedicated FullPool mobile context.
`room_id`	string	64-bit LIVE room Snowflake identifier.
`action`	string	Decoded action value.
`gift_id`	integer	Unique gift identifier.
`gift_name`	string	Decoded gift name value.
`repeat_count`	integer	Total repeat count.
`diamonds_spent`	integer	Decoded diamonds spent value.
`remaining_coins`	integer	Decoded remaining coins value.
`send_msg_id`	string	Unique send msg identifier.
`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(
        "POST",
        "/v1/account/live/gift",
        json_body={
            "account_id": "acc_7Hq2",
            "room_id": "7705861000123456789",
            "action": "send",
            "gift_id": 5655,
            "count": 1,
        },
    )
    print(res.credits_cost, res.data)

{
  "status_code": 0,
  "account_id": "acc_7Hq2",
  "room_id": "7705861000123456789",
  "action": "send",
  "gift_id": 5655,
  "gift_name": "Rose",
  "repeat_count": 1,
  "diamonds_spent": 1,
  "remaining_coins": 489,
  "send_msg_id": "7705861999111222955",
  "log_pb": {
    "impr_id": "202611120200419F8E7D6C5B4A3210"
  }
}

Try it in the playground Full reference in the docs

More in Connected sessions

POST/v1/account/importGrowth+Import session25 cr POST/v1/account/login/otp/sendGrowth+Email sign-in: send code25 cr POST/v1/account/login/otp/verifyGrowth+Email sign-in: verify code25 cr POST/v1/account/sessionGrowth+Refresh session25 cr GET/v1/account/healthGrowth+Session health15 cr POST/v1/account/session/cold-reopenGrowth+Cold reopen lifecycle15 cr POST/v1/account/session/warm-reopenGrowth+Warm reopen lifecycle15 cr POST/v1/account/session/backgroundGrowth+Session background flush10 cr POST/v1/account/session/tickGrowth+Session heartbeat tick10 cr POST/v1/account/applogGrowth+Flush AppLog batch15 cr POST/v1/account/realtime-feedbackGrowth+Realtime feed feedback15 cr POST/v1/account/warm/nicheGrowth+Warm session for niche25 cr POST/v1/account/warm/seed-accountsGrowth+Warm from seed creators25 cr POST/v1/account/warm/watch-itemGrowth+Watch item telemetry15 cr GET/v1/account/upload/precheckGrowth+Upload precheck15 cr POST/v1/account/upload/videoGrowth+Publish video100 cr POST/v1/account/upload/slideshowGrowth+Publish slideshow100 cr POST/v1/account/upload/deleteGrowth+Delete post15 cr POST/v1/account/post/visibilityGrowth+Post visibility15 cr GET/v1/account/upload/placesGrowth+Places for a post15 cr POST/v1/account/profile/updateGrowth+Update profile25 cr POST/v1/account/profile/usernameGrowth+Change username25 cr POST/v1/account/profile/avatarGrowth+Change avatar25 cr POST/v1/account/profile/privacyGrowth+Privacy settings25 cr POST/v1/account/settingsGrowth+App settings15 cr POST/v1/account/wellbeingGrowth+Digital wellbeing15 cr GET/v1/account/studio/overviewGrowth+Studio analytics overview20 cr GET/v1/account/studio/notificationsGrowth+Studio notifications20 cr POST/v1/account/commentGrowth+Post comment25 cr POST/v1/account/comment/likeGrowth+Like comment15 cr POST/v1/account/comment/unlikeGrowth+Unlike comment15 cr POST/v1/account/comment/deleteGrowth+Delete comment15 cr POST/v1/account/likeEnterpriseLike post15 cr POST/v1/account/followEnterpriseFollow creator20 cr POST/v1/account/repostEnterpriseRepost video15 cr POST/v1/account/shareEnterpriseRecord share15 cr POST/v1/account/favoriteEnterpriseBookmark post15 cr POST/v1/account/music/collectEnterpriseCollect sound15 cr GET/v1/account/dm/inboxGrowth+Inbox20 cr GET/v1/account/dm/conversation/listGrowth+Conversations20 cr GET/v1/account/dm/conversation/messagesGrowth+Conversation messages20 cr POST/v1/account/dm/conversation/createGrowth+Start conversation20 cr POST/v1/account/dm/conversation/readGrowth+Mark read20 cr POST/v1/account/dm/typingGrowth+Typing indicator15 cr POST/v1/account/dm/sendGrowth+Send message35 cr POST/v1/account/dm/send-imageGrowth+Send image35 cr POST/v1/account/dm/send-voiceGrowth+Send voice note35 cr POST/v1/account/dm/replyGrowth+Reply to message35 cr POST/v1/account/dm/stickerGrowth+Send sticker35 cr POST/v1/account/dm/share-videoGrowth+Share video35 cr POST/v1/account/dm/reactGrowth+React to message15 cr POST/v1/account/dm/recallGrowth+Unsend message15 cr GET/v1/account/dm/group/infoGrowth+Group info20 cr GET/v1/account/dm/group/membersGrowth+Group members20 cr GET/v1/account/dm/streaksGrowth+Streaks20 cr POST/v1/account/live/startGrowth+Start LIVE100 cr POST/v1/account/live/pingGrowth+LIVE heartbeat15 cr POST/v1/account/live/finishGrowth+End LIVE15 cr POST/v1/account/live/moderateGrowth+Moderate LIVE20 cr POST/v1/account/live/cohostGrowth+Co-host20 cr POST/v1/account/live/battleGrowth+LIVE match20 cr POST/v1/account/live/viewerGrowth+LIVE viewer session20 cr GET/v1/account/shop/cartGrowth+Cart25 cr GET/v1/account/shop/order-centerGrowth+Orders25 cr GET/v1/account/shop/csGrowth+Shop support chat25 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