API Reference

Query Creator Info

Fetch TikTok creator posting options (privacy levels, duration limits, and feature flags) for a connected account.

GET/query-tiktok-creator-info/:userId/:accountId

When userId / accountId are provided, ShareViral loads the stored TikTok access token for that connection. Alternatively, you can pass a TikTok access token in the Authorization header.

Path parameters

Full URL: https://shareviral-server-production.up.railway.app/api/v1/developer/query-tiktok-creator-info/:userId/:accountId

Parameter	Type	Description
`userId`required	string	ShareViral user id that owns the connected TikTok account.
`accountId`required	string	Connected TikTok account id in ShareViral.

Query parameters

Parameter	Type	Description
`businessId`optional	string	Optional business scope when the TikTok account is connected under a business.

Examples

cURL

curl "https://shareviral-server-production.up.railway.app/api/v1/developer/query-tiktok-creator-info/USER_ID/ACCOUNT_ID" \
  -H "Authorization: Bearer <optional_tiktok_access_token>"

Response

Shape follows TikTok’s creator info payload under data. Exact fields can vary by TikTok API version and account permissions.

200 OK

{
  "success": true,
  "data": {
    "creator_avatar_url": "…",
    "creator_username": "…",
    "creator_nickname": "…",
    "privacy_level_options": ["PUBLIC_TO_EVERYONE", "…"],
    "comment_disabled": false,
    "duet_disabled": false,
    "stitch_disabled": false,
    "max_video_post_duration_sec": 600
  }
}