{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/creatordb-app/json-schema/creatordb-app-tiktok-profile-data-schema.json",
  "title": "TiktokProfileData",
  "description": "Profile information of the specified TikTok creator.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/creatordb-app-tiktok-api-openapi.yml#/components/schemas/TiktokProfileData",
  "type": "object",
  "properties": {
    "uniqueId": {
      "type": "string",
      "description": "Account handle."
    },
    "displayName": {
      "type": "string",
      "description": "Account name."
    },
    "category": {
      "type": "string",
      "description": "Professional account category."
    },
    "avatarUrl": {
      "type": "string",
      "description": "Account profile picture URL."
    },
    "bio": {
      "type": "string",
      "description": "The profile biography."
    },
    "isBusinessAccount": {
      "type": "boolean",
      "description": "`true` if it is a business account."
    },
    "isPrivateAccount": {
      "type": "boolean",
      "description": "`true` if it is a private account."
    },
    "isVerified": {
      "type": "boolean",
      "description": "`true` if the account is verified."
    },
    "hasSponsors": {
      "type": "boolean",
      "description": "`true` if there is sponsored content."
    },
    "country": {
      "type": "string",
      "description": "The country in **ISO 3166-1 alpha-3** format. For the country code list, see [here](https://docs.creatordb.app/api-v3/country-code)."
    },
    "mainLanguage": {
      "type": "string",
      "description": "The primary language used in posts, represented in **ISO 639-3** format. For the language code list, see [here](https://docs.creatordb.app/api-v3/language-code)."
    },
    "languages": {
      "type": "array",
      "description": "All languages used in posts, represented in **ISO 639-3** format. For the language code list, see [here](https://docs.creatordb.app/api-v3/language-code).",
      "items": {
        "type": "string"
      }
    },
    "secondLanguage": {
      "type": "string",
      "description": "The secondary language used in posts, represented in **ISO 639-3** format. For language code list, see [here](https://docs.creatordb.app/api-v3/language-code)."
    },
    "totalContents": {
      "type": "integer",
      "description": "Total number of videos.",
      "minimum": 0
    },
    "totalFollowing": {
      "type": "integer",
      "description": "Total number of accounts followed.",
      "minimum": 0
    },
    "totalFollowers": {
      "type": "integer",
      "description": "Total number of followers.",
      "minimum": 0
    },
    "subscriberGrowth": {
      "type": "object",
      "description": "Follower growth metrics over 7, 30, and 90-day periods.",
      "properties": {
        "g7": {
          "type": "number",
          "description": "Follower growth over 7 days, rounded to 4th decimal place."
        },
        "g30": {
          "type": "number",
          "description": "Follower growth over 30 days, rounded to 4th decimal place."
        },
        "g90": {
          "type": "number",
          "description": "Follower growth over 90 days, rounded to 4th decimal place."
        }
      },
      "required": [
        "g7",
        "g30",
        "g90"
      ]
    },
    "hashtags": {
      "type": "array",
      "description": "Hashtags used in TikTok posts and usage statistics.",
      "items": {
        "type": "object",
        "description": "Hashtag information and usage statistics.",
        "properties": {
          "name": {
            "type": "string",
            "description": "Hashtags used in post captions or descriptions."
          },
          "contentCount": {
            "type": "integer",
            "description": "Number of contents using the hashtag.",
            "minimum": 0
          }
        },
        "required": [
          "name",
          "contentCount"
        ]
      }
    },
    "niches": {
      "type": "array",
      "description": "Granular subcategories of content topics identified by CreatorDB's AI model, which analyzes and groups keywords, hashtags, and tags used by creators.",
      "items": {
        "type": "string"
      }
    },
    "otherLinks": {
      "type": "array",
      "description": "Linked websites.",
      "items": {
        "type": "object",
        "description": "Information of external platform links.",
        "properties": {
          "title": {
            "type": "string",
            "description": "The link name."
          },
          "url": {
            "type": "string",
            "description": "The profile or website URL."
          }
        },
        "required": [
          "title",
          "url"
        ]
      }
    },
    "lastPublishTime": {
      "type": "integer",
      "description": "Time the last content was uploaded, represented as a Unix timestamp in milliseconds."
    },
    "lastDbUpdateTime": {
      "type": "integer",
      "description": "Last update time of the creator profile and statistics in the CreatorDB database, represented as a Unix timestamp in milliseconds."
    }
  }
}