Connected session · FullPool

Studio analytics overview

Creator Studio post views, profile views, net followers and top posts.

GETapi.tikultra.com/v1/account/studio/overview20 cr

Upstream/tiktok/v1/analytics/search_studio_card//tiktok/v1/creator/overview/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
`window_days`	integer	Analytics window in days (7, 28, or 60). e.g. 7

Pricing

Plan	Per call	Per 1,000 calls
Starter	20 credits	$2.32
Growth	20 credits	$1.58
Scale	20 credits	$1.16

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.
`window_days`	integer	Decoded window days value.
`metrics`	object	Structured metrics metadata.
`metrics.post_views`	integer	Decoded post views value.
`metrics.profile_views`	integer	Decoded profile views value.
`metrics.likes`	integer	Decoded likes value.
`metrics.comments`	integer	Page of top-level or reply comment objects.
`metrics.shares`	integer	Decoded shares value.
`metrics.net_followers`	integer	Decoded net followers value.
`top_posts`	object[]	List of top posts objects.
`top_posts[].aweme_id`	string	64-bit TikTok Snowflake post ID (top 32 bits encode UTC creation timestamp).
`top_posts[].desc`	string	Post caption text including inline #hashtags and @mentions.
`top_posts[].play_count`	integer	Total play count.
`top_posts[].avg_watch_sec`	number	Unix timestamp (seconds) for avg watch.
`top_posts[].completion_rate_pct`	number	Decoded completion rate pct value.
`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("GET", "/v1/account/studio/overview", params={
        "account_id": "acc_7Hq2",
    })
    print(res.credits_cost, res.data)

{
  "status_code": 0,
  "account_id": "acc_7Hq2",
  "window_days": 7,
  "metrics": {
    "post_views": 492810,
    "profile_views": 18420,
    "likes": 38910,
    "comments": 1940,
    "shares": 4120,
    "net_followers": 2840
  },
  "top_posts": [
    {
      "aweme_id": "7705852133855161377",
      "desc": "Launch film, 1080p60 master #keyboards #desksetup",
      "play_count": 1482906,
      "avg_watch_sec": 24.6,
      "completion_rate_pct": 41.8
    }
  ],
  "log_pb": {
    "impr_id": "202611120200419F8E7D6C5B4A3210"
  }
}

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