{ "$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" } } }