{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/creatordb-app/json-schema/creatordb-app-tiktok-audience-data-schema.json",
  "title": "TiktokAudienceData",
  "description": "Returned audience demographic data of the specified TikTok account.",
  "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/TiktokAudienceData",
  "type": "object",
  "properties": {
    "audienceLocations": {
      "type": [
        "array",
        "null"
      ],
      "description": "Country location of the audience, sorted by descending share.",
      "items": {
        "type": "object",
        "description": "Country distribution of the audience.",
        "properties": {
          "country": {
            "type": "string",
            "description": "The country in **ISO 3166-1 alpha-3** format. For details, see [Country Codes](http://docs.creatordb.app/api-v3/country-code)."
          },
          "share": {
            "type": "number",
            "description": "Proportion of audience from that country, rounded to 4th decimal place."
          }
        },
        "required": [
          "country",
          "share"
        ]
      }
    },
    "audienceGender": {
      "type": [
        "object",
        "null"
      ],
      "description": "Gender distribution of the audience.",
      "properties": {
        "maleRatio": {
          "type": "number",
          "description": "Proportion of male audience, rounded to 4th decimal place."
        },
        "femaleRatio": {
          "type": "number",
          "description": "Proportion of female audience, rounded to 4th decimal place."
        }
      },
      "required": [
        "maleRatio",
        "femaleRatio"
      ]
    },
    "audienceAvgAge": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Average age of the audience, rounded to an integer."
    },
    "audienceAgeBreakdown": {
      "type": [
        "array",
        "null"
      ],
      "description": "Distribution of the audience by age range.",
      "items": {
        "type": "object",
        "description": "Age range distribution of the audience.",
        "properties": {
          "ageRange": {
            "type": "string",
            "enum": [
              "13-17",
              "18-24",
              "25-34",
              "35-44",
              "45-54",
              "55-64",
              "65+"
            ],
            "description": "Age group. <br /> Accepted values: `13-17`, `18-24`, `25-34`, `35-44`, `45-54`, `55-64`, `65+`"
          },
          "share": {
            "type": "number",
            "description": "Percentage of audience in a specific age group, rounded to 4th decimal place."
          }
        },
        "required": [
          "ageRange",
          "share"
        ]
      }
    }
  }
}