> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trypost.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Get TikTok creator info

> Reads what TikTok allows this creator to publish now: the privacy levels to offer as `meta.privacy_level`, whether comments, duets and stitches are off, and the longest video allowed. A creator TikTok does not let post right now comes back with `can_post: false`. Successful answers are kept for 5 minutes. This endpoint also counts against a limit of 60 requests per minute per user, shared with the other Pinterest, Discord, TikTok and Instagram lookup endpoints and with the same user's channel lookups in the TryPost app.



## OpenAPI

````yaml /openapi.json get /social-accounts/{account}/tiktok-creator-info
openapi: 3.1.0
info:
  title: TryPost API
  version: 2.0.0
  description: >-
    REST API for TryPost. Authenticate with a workspace API key as a Bearer
    token.
servers:
  - url: https://app.trypost.it/api
    description: TryPost Cloud
security:
  - bearerAuth: []
tags:
  - name: Posts
    description: Create, read, update, delete and preview posts.
  - name: Post notes
    description: Internal notes on a post, visible to workspace members.
  - name: Approvals
    description: Approve or reject posts waiting for approval.
  - name: Recurrence
    description: Make a post repeat on a schedule.
  - name: Media and uploads
    description: Upload files and attach media to posts.
  - name: Social accounts
    description: Connected social accounts and their network-specific options.
  - name: Channels
    description: A channel's posting schedule and queue.
  - name: Ideas
    description: Ideas on the Create board.
  - name: Idea stages
    description: The groups (columns) of the ideas board.
  - name: Analytics
    description: Workspace and channel insights.
  - name: Labels
    description: Labels to organize posts and ideas.
  - name: Signatures
    description: Reusable text to append to posts.
  - name: Workspace
    description: The workspace the API key belongs to.
  - name: API keys
    description: Personal API keys for this workspace.
  - name: Webhooks
    description: Outgoing webhooks and their delivery logs.
  - name: Repurposes
    description: Automations that republish videos posted outside TryPost.
  - name: Platform
    description: Platform capabilities and content types.
paths:
  /social-accounts/{account}/tiktok-creator-info:
    parameters:
      - $ref: '#/components/parameters/AccountId'
    get:
      tags:
        - Social accounts
      summary: Get TikTok creator info
      description: >-
        Reads what TikTok allows this creator to publish now: the privacy levels
        to offer as `meta.privacy_level`, whether comments, duets and stitches
        are off, and the longest video allowed. A creator TikTok does not let
        post right now comes back with `can_post: false`. Successful answers are
        kept for 5 minutes. This endpoint also counts against a limit of 60
        requests per minute per user, shared with the other Pinterest, Discord,
        TikTok and Instagram lookup endpoints and with the same user's channel
        lookups in the TryPost app.
      operationId: getTikTokCreatorInfo
      responses:
        '200':
          description: The creator's publishing options.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TikTokCreatorInfo'
              example:
                can_post: true
                privacy_level_options:
                  - PUBLIC_TO_EVERYONE
                  - MUTUAL_FOLLOW_FRIENDS
                  - SELF_ONLY
                comment_disabled: false
                duet_disabled: false
                stitch_disabled: true
                max_video_post_duration_sec: 600
                creator_nickname: TryPost
                creator_username: trypost.it
                creator_avatar_url: https://p16-sign.tiktokcdn.com/avatar.jpeg
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          description: The account is not a TikTok account.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
              example:
                message: Creator info is only available for TikTok accounts.
        '429':
          description: >-
            Our rate limit was exceeded, or TikTok reports a limit (daily post
            cap, quota or rate limit). For a TikTok limit, `Retry-After` is set
            when TikTok says when it lifts.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/RateLimitErrorBody'
                  - $ref: '#/components/schemas/ErrorBody'
        '500':
          description: >-
            The TikTok connection could not be refreshed (for example, no
            refresh token). Reconnect the account in the app.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
              example:
                message: Server Error
        '502':
          description: >-
            TikTok answered with an error, or a refresh of this account's TikTok
            token is already running (`A TikTok token refresh is already in
            progress.`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
              example:
                message: TikTok didn't answer. Try again in a moment.
        '503':
          description: TikTok did not answer in time.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
              example:
                message: TikTok didn't answer. Try again in a moment.
components:
  parameters:
    AccountId:
      name: account
      in: path
      required: true
      description: >-
        Social account (channel) id. An account of another workspace returns
        `404`.
      schema:
        type: string
        format: uuid
      example: 9c8b7a65-4d3e-4f2a-8b1c-0d9e8f7a6b54
  schemas:
    TikTokCreatorInfo:
      type: object
      description: What TikTok allows this creator to publish right now.
      properties:
        can_post:
          type: boolean
          description: >-
            `false` when TikTok answered that the creator cannot post now (no
            privacy options).
        privacy_level_options:
          type: array
          items:
            type: string
            enum:
              - PUBLIC_TO_EVERYONE
              - MUTUAL_FOLLOW_FRIENDS
              - FOLLOWER_OF_CREATOR
              - SELF_ONLY
          description: Values allowed for `meta.privacy_level` on this account.
        comment_disabled:
          type: boolean
          description: >-
            Comments are off in the creator's TikTok settings: `allow_comments`
            has no effect.
        duet_disabled:
          type: boolean
        stitch_disabled:
          type: boolean
        max_video_post_duration_sec:
          type:
            - integer
            - 'null'
          description: Longest video this creator may post, in seconds.
        creator_nickname:
          type:
            - string
            - 'null'
        creator_username:
          type:
            - string
            - 'null'
        creator_avatar_url:
          type:
            - string
            - 'null'
    ErrorBody:
      type: object
      properties:
        message:
          type: string
    RateLimitErrorBody:
      type: object
      properties:
        name:
          type: string
          const: rate_limit_exceeded
        message:
          type: string
          examples:
            - Rate limit exceeded. Please retry after 30 seconds.
  responses:
    Unauthorized:
      description: >-
        Missing, invalid, revoked or expired API key. Bodies: `Unauthenticated.`
        (no key, or a key that is invalid or revoked), `Token expired.` (past
        its `expires_at`), `Token not found.` and `No workspace selected.` (the
        key is no longer bound to a workspace).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
          example:
            message: Unauthenticated.
    PaymentRequired:
      description: >-
        TryPost Cloud only: the workspace's account has no active subscription
        or trial. Body: `{"message": "Active subscription required."}`.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
          example:
            message: Active subscription required.
    Forbidden:
      description: >-
        The request is not allowed. API keys work only for workspace admins (the
        account owner or a member marked as admin): otherwise every request
        returns `Insufficient workspace permissions.`. Other bodies: `Workspace
        access denied.` (the key's user left the workspace) and `Personal access
        token required.` (an MCP OAuth token was sent) and `This action is
        unauthorized.` (the note belongs to another member).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
    NotFound:
      description: The resource does not exist in this workspace.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorBody'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Workspace API key from Settings → API Keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.