API reference / Connected sessions / Follow creator

Follow creator

Follow or unfollow a creator from an authorized Enterprise session.

POSTapi.tikultra.com/v1/account/follow20 credits

Upstream: /aweme/v1/commit/follow/user/
Access: Enterprise
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.

target_user_idstringrequired

Target numeric user ID. For example 6970000000000000002.

target_sec_uidstring

Target sec_uid. For example MS4wLjABAAAAkbfan991xQp2mN8vR4wL7tH3zK5y.

actioninteger

1 to follow, 0 to unfollow. For example 1.

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.

target_user_idstring

Unique target user identifier.

target_sec_uidstring

Decoded target sec uid value.

follow_statusinteger

Decoded follow status value.

watch_statusinteger

Decoded watch status 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.

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

Enterprise only. This endpoint is enabled per contract for authorized accounts. Talk to us.

import os from tikultra import TikUltra with TikUltra(api_key=os.environ["TIKULTRA_KEY"]) as client: res = client.request( "POST", "/v1/account/follow", json_body={ "account_id": "acc_7Hq2", "target_user_id": "6970000000000000002", "target_sec_uid": "MS4wLjABAAAAkbfan991xQp2mN8vR4wL7tH3zK5y", "action": 1, }, ) print(res.credits_cost, res.data)

{ "status_code": 0, "account_id": "acc_7Hq2", "target_user_id": "6970000000000000002", "target_sec_uid": "MS4wLjABAAAAkbfan991xQp2mN8vR4wL7tH3zK5y", "follow_status": 1, "watch_status": 0, "log_pb": { "impr_id": "202611120200419F8E7D6C5B4A3210" } }