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

# Get creator intelligence scorecard

> Computes a comprehensive intelligence scorecard for a public TikTok creator based on their profile and recent posting history.

Computes a comprehensive intelligence scorecard for a public TikTok creator based on their profile and recent posting history.

Scores are computed from up to 30 recent posts and include:

* **engagement\_rate** — mean (likes + comments + shares) / plays across posts
* **engagement\_percentile** — engagement rate relative to TikTok creator benchmarks
* **posting\_consistency** — regularity of publishing intervals (0 = erratic, 100 = perfectly consistent)
* **niche\_concentration** — how tightly focused the creator's content is on one topic
* **follower\_growth\_score** — estimated growth velocity based on follower-to-likes ratio
* **creator\_authority\_score** — composite of the above scores
* **partnership\_tier** — tier\_1 (≥80), tier\_2 (60–79), tier\_3 (40–59), tier\_4 (\<40)

Results are cached for 30 minutes.


## OpenAPI

````yaml GET /api/v1/intelligence/creator/{username}
openapi: 3.0.3
info:
  title: TikTok Intel API
  version: 2025-01
  description: >-
    Real-time TikTok data API — creator intelligence, user profiles, posts,
    sounds,

    search, live streams, effects, places, collections, and challenges.


    ### Response Envelope


    Every response follows the same structure:


    ```json

    {
      "meta": {
        "request_id": "550e8400-e29b-41d4-a716-446655440000",
        "timestamp": "2025-04-29T12:00:00.000Z",
        "cached": false,
        "version": "2025-01"
      },
      "data": { ... },
      "pagination": null,
      "error": null
    }

    ```


    Paginated list endpoints include a `pagination` object with `cursor` and
    `has_more`.

    On error, `data` is `null` and `error` carries `code` and `message`.


    ### Field Names


    All public fields use `snake_case`. Internal TikTok identifiers (`secUid`,
    `bitrateInfo`, etc.) are never exposed.


    ### Caching


    `meta.cached: true` means the response was served from cache. TTLs vary by
    category (2 min for live data, 30 min for profiles).
  contact:
    name: API Support
    url: https://rapidapi.com
servers:
  - url: https://full-tiktok-api.p.rapidapi.com
    description: Production
security: []
tags:
  - name: Users
    description: TikTok user profiles, posts, followers, and playlists
  - name: Posts
    description: TikTok video post metadata and comments
  - name: Sounds
    description: TikTok sounds, music tracks, and commercial library
  - name: Search
    description: Keyword search across videos, users, live rooms, and suggestions
  - name: Live
    description: TikTok live stream rooms, categories, and streaming status
  - name: Effects
    description: TikTok AR effects and associated videos
  - name: Places
    description: TikTok location tags and geotagged posts
  - name: Collections
    description: TikTok user-created collections and playlists
  - name: Challenges
    description: TikTok hashtag challenges and associated posts
  - name: Intelligence
    description: Computed creator analytics, scores, and partnership intelligence
paths:
  /api/v1/intelligence/creator/{username}:
    get:
      tags:
        - Intelligence
      summary: Get creator intelligence scorecard
      description: >-
        Computes a comprehensive intelligence scorecard for a public TikTok
        creator based on their profile and recent posting history.
      operationId: intelligence_creator
      parameters:
        - name: username
          in: path
          required: true
          description: TikTok username (with or without @). Account must be public.
          schema:
            type: string
          example: charlidamelio
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  meta:
                    $ref: '#/components/schemas/Meta'
                  data:
                    $ref: '#/components/schemas/CreatorScorecard'
                  pagination:
                    $ref: '#/components/schemas/NullPagination'
                  error:
                    $ref: '#/components/schemas/ErrorObject'
        '400':
          description: '**INVALID_PARAM**: username is empty after stripping @'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '401':
          description: '**UNAUTHORIZED**: Missing or invalid x-rapidapi-key header'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '403':
          description: '**PRIVATE_ACCOUNT**: the creator''s account is set to private'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '404':
          description: '**NOT_FOUND**: no TikTok user found for the given username'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '502':
          description: >-
            **UPSTREAM_ERROR**: upstream API is unavailable or returned an
            error; **RESOLUTION_FAILED**: user profile was found but secUid
            could not be resolved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      security:
        - RapidApiKey: []
components:
  schemas:
    Meta:
      type: object
      description: Response metadata present in every API response
      properties:
        request_id:
          type: string
          format: uuid
          description: Unique ID for this request
          example: 3c90c3cc-0d44-4b50-8888-8dd25736052a
        timestamp:
          type: string
          format: date-time
          description: ISO 8601 server time when the response was generated
          example: '2025-03-12T14:32:01.498Z'
        cached:
          type: boolean
          description: true if the response was served from cache
          example: false
        version:
          type: string
          example: 2025-01
          description: API version string
    CreatorScorecard:
      description: Computed intelligence scorecard for a TikTok creator
      type: object
      properties:
        profile:
          type: object
          description: Creator profile snapshot
          properties:
            username:
              type: string
              nullable: true
              description: TikTok username
              example: charlidamelio
            display_name:
              type: string
              nullable: true
              description: Display name
              example: charli d'amelio
            verified:
              type: boolean
              description: Verified status
              example: true
            avatar_url:
              type: string
              nullable: true
              format: uri
              description: Avatar image URL
              example: https://p16-sign.tiktokcdn-us.com/...
            bio:
              type: string
              nullable: true
              description: Profile bio text
              example: just a girl who loves to dance
        audience:
          type: object
          description: Audience size metrics
          properties:
            followers:
              type: integer
              description: Follower count
              example: 158200000
            following:
              type: integer
              description: Following count
              example: 1400
            total_likes:
              type: integer
              description: Total likes received
              example: 11000000000
            total_videos:
              type: integer
              description: Total videos posted
              example: 3141
        scores:
          type: object
          description: Computed intelligence scores (all 0–100 unless noted)
          properties:
            engagement_rate:
              type: number
              description: Mean engagement rate across recent posts (0–100+)
              example: 9.5
            engagement_percentile:
              type: integer
              description: Engagement rate percentile vs TikTok benchmarks (0–100)
              example: 98
            posting_consistency:
              type: integer
              description: Posting schedule regularity score (0–100)
              example: 59
            niche_concentration:
              type: integer
              description: How tightly focused the creator is on one niche (0–100)
              example: 100
            follower_growth_score:
              type: integer
              description: Estimated follower growth velocity score (0–100)
              example: 42
            creator_authority_score:
              type: integer
              description: Composite authority score (0–100)
              example: 77
            partnership_tier:
              type: string
              description: >-
                Partnership tier based on authority: tier_1 (≥80) through tier_4
                (<40)
              example: tier_2
        intelligence:
          type: object
          description: Analysis metadata
          properties:
            primary_niche:
              type: string
              nullable: true
              description: Top hashtag/topic representing the creator's primary niche
              example: fitness
            posts_analyzed:
              type: integer
              description: Number of recent posts used in the analysis
              example: 15
            analysis_timestamp:
              type: string
              format: date-time
              description: ISO 8601 timestamp of when the analysis was computed
              example: '2025-03-12T14:32:01.498Z'
            low_sample_warning:
              type: boolean
              nullable: true
              description: >-
                Present and true if fewer than 3 posts were available for
                analysis
              example: false
    NullPagination:
      type: object
      nullable: true
      example: null
      description: >-
        Always null; this endpoint returns a single object and does not
        paginate.
    ErrorObject:
      type: object
      nullable: true
      description: Error details. Present only when the request failed; null on success.
      properties:
        code:
          type: string
          description: Machine-readable error code in SCREAMING_SNAKE_CASE
          example: NOT_FOUND
        message:
          type: string
          description: Human-readable error description
          example: The requested resource was not found.
        details:
          description: Additional context, if available
          nullable: true
          example: null
    ErrorEnvelope:
      type: object
      description: Standard error response envelope returned for all 4xx and 5xx responses.
      properties:
        meta:
          $ref: '#/components/schemas/Meta'
        data:
          type: object
          nullable: true
          example: null
          description: Always null on error.
        pagination:
          type: object
          nullable: true
          example: null
          description: Always null on error.
        error:
          $ref: '#/components/schemas/ErrorObject'
  securitySchemes:
    RapidApiKey:
      type: apiKey
      in: header
      name: x-rapidapi-key
      description: >-
        Your RapidAPI subscription key. Injected automatically by the RapidAPI
        gateway in production.

````