API reference / Connected sessions / Studio notifications

Studio notifications

Creator Studio milestones, policy notices and content-gap alerts.

GETapi.tikultra.com/v1/account/studio/notifications20 credits

Upstream: /aweme/v1/notice/multi/
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.

Query parameters

account_idstringrequired

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

cursorstring

The cursor from the previous page. Omit it for the first page.

countinteger

Items per page. For example 20.

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.

unread_countinteger

Total unread count.

itemsobject[]

Page of normalized records returned by this endpoint.

items[].notice_idstring

Unique notice identifier.

items[].categorystring

Decoded category value.

items[].titlestring

Decoded title value.

items[].aweme_idstring

64-bit TikTok Snowflake post ID (top 32 bits encode UTC creation timestamp).

items[].create_timeinteger

Unix timestamp (seconds) when the item was created.

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.

import os from tikultra import TikUltra with TikUltra(api_key=os.environ["TIKULTRA_KEY"]) as client: res = client.request("GET", "/v1/account/studio/notifications", params={ "account_id": "acc_7Hq2", }) print(res.credits_cost, res.data)

{ "status_code": 0, "account_id": "acc_7Hq2", "unread_count": 2, "items": [ { "notice_id": "stu_ntc_01", "category": "milestone", "title": "Your post passed 1M views", "aweme_id": "7705852133855161377", "create_time": 1794393600 }, { "notice_id": "stu_ntc_02", "category": "search_insight", "title": "High content-gap topic in your niche: low profile switches", "topic_id": "7420998877665544332", "create_time": 1794379200 } ], "log_pb": { "impr_id": "202611120200419F8E7D6C5B4A3210" } }