Creator profile

Returns one creator’s profile as this shop sees them. Look up by exactly one of openId or username (with or without @; an old handle still finds the creator).

creator and marketplaceStats are platform-wide: ids, usernames, followers and profile URL, plus TikTok’s 30-day fulfillment rate, median video views, GMV and video count as last seen (null if never captured). sales is the creator’s affiliate GMV for this shop, as lifetime and last28Days (UTC days). content counts the creator’s posts for this shop with views, likes and comments. samples and showcase count relationships by state, and segments lists the segments the creator is in.

breakdown=true adds GMV by content type and the top 10 products. If that part takes too long, breakdownStatus is timeout and the totals still stand. A creator Growi has no data on returns found: false. Served from Growi’s synced data, so recent days can lag (sweptThrough).

GET /tik_tok_shop/creators/profile

Creator profile

cURL

curl --request GET \
  --url https://api.growi.io/api/public/v1/tik_tok_shop/creators/profile \
  --header 'Authorization: Bearer <token>'

200

{
  "lookup": {
    "username": "creator_one"
  },
  "found": true,
  "creator": {
    "openId": "uACafQAAAABexampleOpenId0000000",
    "oecId": "7494000000000000301",
    "username": "creator_one",
    "previousUsernames": [
      "creator_one_old"
    ],
    "nickname": "Creator One",
    "avatarUrl": null,
    "followerCount": 48200,
    "secUid": "MS4wLjABAAAAexampleSecUid000000000000000000000000",
    "profileUrl": "https://www.tiktok.com/@creator_one",
    "firstSeenAt": "2026-01-02T10:00:00.000Z",
    "lastSeenAt": "2026-03-01T08:30:00.000Z"
  },
  "marketplaceStats": {
    "fulfillmentRate": 96.5,
    "medianVideoViews": 1800,
    "gmvAmount": "4520.10",
    "gmvCurrency": "USD",
    "videoCount": 140
  },
  "sales": {
    "currency": "USD",
    "usernames": [
      "creator_one",
      "creator_one_old"
    ],
    "lifetime": {
      "gmvGross": 1830.5,
      "orders": 61,
      "itemsSold": 70,
      "commissionEstimated": 274.58,
      "firstSaleDay": "2026-01-05",
      "lastOrderAt": "2026-02-28T21:14:00.000Z"
    },
    "last28Days": {
      "from": "2026-02-02",
      "to": "2026-03-01",
      "gmvGross": 420,
      "orders": 14,
      "itemsSold": 15,
      "commissionEstimated": 63
    },
    "breakdown": null,
    "breakdownStatus": "not_requested"
  },
  "content": {
    "videos": 9,
    "lives": 1,
    "views": 152000,
    "likes": 8400,
    "comments": 310,
    "lastPostedAt": "2026-02-27T18:00:00.000Z"
  },
  "samples": {
    "total": 3,
    "byState": {
      "content_fulfilled": 2,
      "sample_shipped": 1
    }
  },
  "showcase": {
    "total": 1,
    "byState": {
      "added_to_showcase": 1
    }
  },
  "segments": [
    {
      "segmentId": "seg_example_1",
      "name": "Top sellers"
    }
  ],
  "sweptThrough": "2026-03-01T06:00:00.000Z",
  "note": "Everything here comes from rows the gateway already holds, not a live TikTok call."
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

openId · string

The creator's open id. Pass exactly one of openId or username.

username · string

The creator's TikTok handle, with or without @. Pass exactly one of openId or username.

breakdown · enum<string> · default: false

true adds GMV by content type and the top 10 products, read from the order lines (bounded, fails soft).

Available options: true, false

organization_id · integer

Use the TikTok Shop of this child brand (organization id) of your API key's organization

Response

200

application/json

{ lookup, found, creator: { openId, oecId, username, previousUsernames, nickname, avatarUrl, followerCount, secUid, profileUrl, firstSeenAt, lastSeenAt } | null, marketplaceStats: { fulfillmentRate, medianVideoViews, gmvAmount, gmvCurrency, videoCount } | null, sales: { currency, usernames, lifetime: { gmvGross, orders, itemsSold, commissionEstimated, firstSaleDay, lastOrderAt }, last28Days: { from, to, gmvGross, orders, itemsSold, commissionEstimated }, breakdown: { byContentType: [{ contentType, gmvGross, orders, itemsSold }], topProducts: [{ productId, title, gmvGross, orders, itemsSold }] } | null, breakdownStatus }, content: { videos, lives, views, likes, comments, lastPostedAt }, samples: { total, byState }, showcase: { total, byState }, segments: [{ segmentId, name }], sweptThrough, note }.