Openhandle · Schema

TikTokProfile

Social DataInstagramTikToktwitterRedditPublic Datasocial-media-apiMCPcreator-analyticsSocial Listening

Properties

Name Type Description
accountType integernull
avatar object
bio stringnull
category stringnull
commerce object
createdAt stringnull
displayName stringnull
handle string
id string
isAdVirtual booleannull
isCanceled booleannull
isDisciplineMember booleannull
isEffectArtist booleannull
isPrivate booleannull
isStar booleannull
isVerified booleannull
language stringnull
metrics object
music object
predictions object
privacy object
regionCode stringnull
searchContext object
secUid stringnull
socialLinks arraynull
stories object
storyStatus integernull
url string
verification object
View JSON Schema on GitHub

JSON Schema

openhandle-tik-tok-profile-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/openhandle/main/json-schema/openhandle-tik-tok-profile-schema.json",
  "title": "TikTokProfile",
  "x-generated": "2026-09-21",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/openhandle-openapi.yml#/components/schemas/TikTokProfile",
  "additionalProperties": false,
  "properties": {
    "accountType": {
      "type": [
        "integer",
        "null"
      ]
    },
    "avatar": {
      "anyOf": [
        {
          "$ref": "#/$defs/TikTokAsset"
        },
        {
          "type": "null"
        }
      ]
    },
    "bio": {
      "minLength": 1,
      "type": [
        "string",
        "null"
      ]
    },
    "category": {
      "minLength": 1,
      "type": [
        "string",
        "null"
      ]
    },
    "commerce": {
      "additionalProperties": false,
      "properties": {
        "hasLiveCommerce": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "hasNewProducts": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "level": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "level",
        "hasLiveCommerce",
        "hasNewProducts"
      ],
      "type": "object"
    },
    "createdAt": {
      "format": "date-time",
      "minLength": 1,
      "type": [
        "string",
        "null"
      ]
    },
    "displayName": {
      "minLength": 1,
      "type": [
        "string",
        "null"
      ]
    },
    "handle": {
      "minLength": 1,
      "type": "string"
    },
    "id": {
      "minLength": 1,
      "type": "string"
    },
    "isAdVirtual": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "isCanceled": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "isDisciplineMember": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "isEffectArtist": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "isPrivate": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "isStar": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "isVerified": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "language": {
      "minLength": 1,
      "type": [
        "string",
        "null"
      ]
    },
    "metrics": {
      "$ref": "#/$defs/TikTokProfileMetrics"
    },
    "music": {
      "additionalProperties": false,
      "properties": {
        "metrics": {
          "additionalProperties": false,
          "properties": {
            "likes": {
              "type": [
                "integer",
                "null"
              ]
            },
            "tracks": {
              "type": [
                "integer",
                "null"
              ]
            },
            "uses": {
              "type": [
                "integer",
                "null"
              ]
            }
          },
          "required": [
            "tracks",
            "uses",
            "likes"
          ],
          "type": "object"
        },
        "newReleaseIds": {
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        }
      },
      "required": [
        "metrics",
        "newReleaseIds"
      ],
      "type": "object"
    },
    "predictions": {
      "additionalProperties": false,
      "properties": {
        "ageGroup": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "ageGroup"
      ],
      "type": "object"
    },
    "privacy": {
      "additionalProperties": false,
      "properties": {
        "followingVisibility": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "followingVisibility"
      ],
      "type": "object"
    },
    "regionCode": {
      "minLength": 1,
      "type": [
        "string",
        "null"
      ]
    },
    "searchContext": {
      "additionalProperties": false,
      "properties": {
        "description": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "nameField": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "description",
        "name",
        "nameField"
      ],
      "type": "object"
    },
    "secUid": {
      "minLength": 1,
      "type": [
        "string",
        "null"
      ]
    },
    "socialLinks": {
      "items": {
        "$ref": "#/$defs/TikTokSocialLink"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "stories": {
      "additionalProperties": false,
      "properties": {
        "changedAt": {
          "format": "date-time",
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "items": {
          "items": {
            "$ref": "#/$defs/TikTokStoryReference"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "metrics": {
          "additionalProperties": false,
          "properties": {
            "countsByPostType": {
              "items": {
                "$ref": "#/$defs/TikTokStoryCount"
              },
              "type": [
                "array",
                "null"
              ]
            }
          },
          "required": [
            "countsByPostType"
          ],
          "type": "object"
        }
      },
      "required": [
        "items",
        "changedAt",
        "metrics"
      ],
      "type": "object"
    },
    "storyStatus": {
      "type": [
        "integer",
        "null"
      ]
    },
    "url": {
      "format": "uri",
      "minLength": 1,
      "type": "string"
    },
    "verification": {
      "additionalProperties": false,
      "properties": {
        "badgeType": {
          "type": [
            "integer",
            "null"
          ]
        },
        "customLabel": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "label": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "type": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "type",
        "badgeType",
        "label",
        "customLabel"
      ],
      "type": "object"
    }
  },
  "required": [
    "id",
    "secUid",
    "handle",
    "displayName",
    "bio",
    "url",
    "createdAt",
    "avatar",
    "isPrivate",
    "isVerified",
    "accountType",
    "isEffectArtist",
    "isAdVirtual",
    "isStar",
    "storyStatus",
    "isDisciplineMember",
    "isCanceled",
    "regionCode",
    "language",
    "category",
    "verification",
    "metrics",
    "commerce",
    "privacy",
    "music",
    "predictions",
    "searchContext",
    "socialLinks",
    "stories"
  ],
  "type": "object",
  "$defs": {
    "TikTokAsset": {
      "additionalProperties": false,
      "properties": {
        "bitrate": {
          "type": [
            "integer",
            "null"
          ]
        },
        "codecCode": {
          "type": [
            "integer",
            "null"
          ]
        },
        "covers": {
          "items": {
            "$ref": "#/$defs/TikTokAsset"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "duration": {
          "type": [
            "number",
            "null"
          ]
        },
        "expiresAt": {
          "format": "date-time",
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "format": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "frameRate": {
          "type": [
            "number",
            "null"
          ]
        },
        "hasWatermark": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "hash": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "height": {
          "type": [
            "integer",
            "null"
          ]
        },
        "id": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "isAutoGenerated": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "isBytevc1": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "isOriginal": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "label": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "language": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "locale": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "previewThumbnails": {
          "items": {
            "$ref": "#/$defs/TikTokPreviewThumbnails"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "qualityCode": {
          "type": [
            "integer",
            "null"
          ]
        },
        "qualityLabel": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "renditions": {
          "items": {
            "$ref": "#/$defs/TikTokAsset"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "role": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "size": {
          "type": [
            "integer",
            "null"
          ]
        },
        "subtitles": {
          "items": {
            "$ref": "#/$defs/TikTokAsset"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "type": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "url": {
          "format": "uri",
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "variants": {
          "items": {
            "$ref": "#/$defs/TikTokAsset"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "version": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "volumeInfo": {
          "$ref": "#/$defs/TikTokVolumeInfo"
        },
        "width": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "volumeInfo",
        "id",
        "type",
        "url",
        "width",
        "height",
        "size",
        "hash",
        "role",
        "label",
        "duration",
        "hasWatermark",
        "qualityLabel",
        "qualityCode",
        "bitrate",
        "frameRate",
        "isBytevc1",
        "codecCode",
        "format",
        "language",
        "locale",
        "isAutoGenerated",
        "isOriginal",
        "version",
        "expiresAt",
        "renditions",
        "covers",
        "subtitles",
        "previewThumbnails",
        "variants"
      ],
      "type": "object"
    },
    "TikTokPreviewThumbnails": {
      "additionalProperties": false,
      "properties": {
        "columns": {
          "type": [
            "integer",
            "null"
          ]
        },
        "duration": {
          "type": [
            "number",
            "null"
          ]
        },
        "format": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "imageCount": {
          "type": [
            "integer",
            "null"
          ]
        },
        "imageIds": {
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "images": {
          "items": {
            "$ref": "#/$defs/TikTokAsset"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "interval": {
          "type": [
            "number",
            "null"
          ]
        },
        "rows": {
          "type": [
            "integer",
            "null"
          ]
        },
        "tileHeight": {
          "type": [
            "integer",
            "null"
          ]
        },
        "tileWidth": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "duration",
        "interval",
        "imageCount",
        "columns",
        "rows",
        "tileWidth",
        "tileHeight",
        "format",
        "images",
        "imageIds"
      ],
      "type": "object"
    },
    "TikTokProfileMetrics": {
      "additionalProperties": false,
      "properties": {
        "followers": {
          "type": [
            "integer",
            "null"
          ]
        },
        "following": {
          "type": [
            "integer",
            "null"
          ]
        },
        "likedPosts": {
          "type": [
            "integer",
            "null"
          ]
        },
        "likes": {
          "type": [
            "integer",
            "null"
          ]
        },
        "posts": {
          "type": [
            "integer",
            "null"
          ]
        },
        "visiblePosts": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "followers",
        "following",
        "posts",
        "visiblePosts",
        "likes",
        "likedPosts"
      ],
      "type": "object"
    },
    "TikTokSocialLink": {
      "additionalProperties": false,
      "properties": {
        "displayName": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "handle": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "id": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "platform": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "url": {
          "format": "uri",
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "platform",
        "id",
        "handle",
        "displayName",
        "url"
      ],
      "type": "object"
    },
    "TikTokStoryCount": {
      "additionalProperties": false,
      "properties": {
        "count": {
          "type": [
            "integer",
            "null"
          ]
        },
        "postTypeCode": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "postTypeCode",
        "count"
      ],
      "type": "object"
    },
    "TikTokStoryReference": {
      "additionalProperties": false,
      "properties": {
        "expiresAt": {
          "format": "date-time",
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "id": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "mediaTypeCode": {
          "type": [
            "integer",
            "null"
          ]
        },
        "postTypeCode": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "id",
        "mediaTypeCode",
        "postTypeCode",
        "expiresAt"
      ],
      "type": "object"
    },
    "TikTokVolumeInfo": {
      "additionalProperties": false,
      "properties": {
        "loudness": {
          "type": [
            "number",
            "null"
          ]
        },
        "loudnessRange": {
          "type": [
            "number",
            "null"
          ]
        },
        "loudnessRangeEnd": {
          "type": [
            "number",
            "null"
          ]
        },
        "loudnessRangeStart": {
          "type": [
            "number",
            "null"
          ]
        },
        "maxVolume": {
          "type": [
            "number",
            "null"
          ]
        },
        "maximumMomentaryLoudness": {
          "type": [
            "number",
            "null"
          ]
        },
        "maximumShortTermLoudness": {
          "type": [
            "number",
            "null"
          ]
        },
        "meanVolume": {
          "type": [
            "number",
            "null"
          ]
        },
        "peak": {
          "type": [
            "number",
            "null"
          ]
        },
        "version": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "loudness",
        "peak",
        "loudnessRange",
        "loudnessRangeStart",
        "loudnessRangeEnd",
        "maximumMomentaryLoudness",
        "maximumShortTermLoudness",
        "version",
        "maxVolume",
        "meanVolume"
      ],
      "type": "object"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/openhandle-tik-tok-profile"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.