Openhandle · Schema

TikTokPost

Social DataInstagramTikToktwitterRedditPublic Datasocial-media-apiMCPcreator-analyticsSocial Listening

Properties

Name Type Description
ai object
audio object
author object
authorId stringnull
caption object
collaborators arraynull
commerce object
cover object
createdAt string
description stringnull
effects arraynull
entities arraynull
hasDanmaku booleannull
hasPromotionalMusic booleannull
hashtags array
id string
isAd booleannull
isMeme booleannull
isPaidContent booleannull
isPinned booleannull
isVr booleannull
language stringnull
locations arraynull
media array
metrics object
musicContext object
onScreenText arraynull
paidCollectionId stringnull
playlist object
region stringnull
searchContext object
status object
stickers arraynull
template object
text stringnull
title stringnull
type stringnull
url string
View JSON Schema on GitHub

JSON Schema

openhandle-tik-tok-post-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-post-schema.json",
  "title": "TikTokPost",
  "x-generated": "2026-09-21",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/openhandle-openapi.yml#/components/schemas/TikTokPost",
  "additionalProperties": false,
  "properties": {
    "ai": {
      "$ref": "#/$defs/TikTokPostAI"
    },
    "audio": {
      "$ref": "#/$defs/TikTokPostAudio"
    },
    "author": {
      "anyOf": [
        {
          "$ref": "#/$defs/TikTokProfileReference"
        },
        {
          "type": "null"
        }
      ]
    },
    "authorId": {
      "minLength": 1,
      "type": [
        "string",
        "null"
      ]
    },
    "caption": {
      "$ref": "#/$defs/TikTokPostCaption"
    },
    "collaborators": {
      "items": {
        "$ref": "#/$defs/TikTokCollaborator"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "commerce": {
      "$ref": "#/$defs/TikTokPostCommerce"
    },
    "cover": {
      "anyOf": [
        {
          "$ref": "#/$defs/TikTokAsset"
        },
        {
          "type": "null"
        }
      ]
    },
    "createdAt": {
      "format": "date-time",
      "minLength": 1,
      "type": "string"
    },
    "description": {
      "minLength": 1,
      "type": [
        "string",
        "null"
      ]
    },
    "effects": {
      "items": {
        "$ref": "#/$defs/TikTokEffectReference"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "entities": {
      "items": {
        "$ref": "#/$defs/TikTokTextEntity"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "hasDanmaku": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "hasPromotionalMusic": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "hashtags": {
      "items": {
        "$ref": "#/$defs/TikTokHashtagReference"
      },
      "type": "array"
    },
    "id": {
      "minLength": 1,
      "type": "string"
    },
    "isAd": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "isMeme": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "isPaidContent": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "isPinned": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "isVr": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "language": {
      "minLength": 1,
      "type": [
        "string",
        "null"
      ]
    },
    "locations": {
      "items": {
        "$ref": "#/$defs/TikTokLocationReference"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "media": {
      "items": {
        "$ref": "#/$defs/TikTokAsset"
      },
      "type": "array"
    },
    "metrics": {
      "$ref": "#/$defs/TikTokPostMetrics"
    },
    "musicContext": {
      "$ref": "#/$defs/TikTokMusicContext"
    },
    "onScreenText": {
      "items": {
        "$ref": "#/$defs/TikTokUnspecified"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "paidCollectionId": {
      "minLength": 1,
      "type": [
        "string",
        "null"
      ]
    },
    "playlist": {
      "anyOf": [
        {
          "$ref": "#/$defs/TikTokPlaylistReference"
        },
        {
          "type": "null"
        }
      ]
    },
    "region": {
      "minLength": 1,
      "type": [
        "string",
        "null"
      ]
    },
    "searchContext": {
      "$ref": "#/$defs/TikTokPostSearchContext"
    },
    "status": {
      "$ref": "#/$defs/TikTokPostStatus"
    },
    "stickers": {
      "items": {
        "$ref": "#/$defs/TikTokInteractionSticker"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "template": {
      "anyOf": [
        {
          "$ref": "#/$defs/TikTokPostTemplate"
        },
        {
          "type": "null"
        }
      ]
    },
    "text": {
      "minLength": 1,
      "type": [
        "string",
        "null"
      ]
    },
    "title": {
      "minLength": 1,
      "type": [
        "string",
        "null"
      ]
    },
    "type": {
      "minLength": 1,
      "type": [
        "string",
        "null"
      ]
    },
    "url": {
      "format": "uri",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "id",
    "type",
    "url",
    "text",
    "title",
    "description",
    "region",
    "language",
    "createdAt",
    "author",
    "authorId",
    "isAd",
    "isPaidContent",
    "isVr",
    "hasPromotionalMusic",
    "hasDanmaku",
    "isPinned",
    "isMeme",
    "media",
    "cover",
    "metrics",
    "status",
    "ai",
    "commerce",
    "entities",
    "hashtags",
    "locations",
    "caption",
    "searchContext",
    "collaborators",
    "audio",
    "template",
    "paidCollectionId",
    "onScreenText",
    "playlist",
    "effects",
    "stickers",
    "musicContext"
  ],
  "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"
    },
    "TikTokBeatData": {
      "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"
          ]
        },
        "resources": {
          "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",
        "resources"
      ],
      "type": "object"
    },
    "TikTokCollaborator": {
      "additionalProperties": false,
      "properties": {
        "profile": {
          "$ref": "#/$defs/TikTokProfileReference"
        },
        "status": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "profile",
        "status"
      ],
      "type": "object"
    },
    "TikTokCommerceMetrics": {
      "additionalProperties": false,
      "properties": {
        "products": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "products"
      ],
      "type": "object"
    },
    "TikTokCoordinates": {
      "additionalProperties": false,
      "properties": {
        "geohash": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "latitude": {
          "type": [
            "number",
            "null"
          ]
        },
        "longitude": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "latitude",
        "longitude",
        "geohash"
      ],
      "type": "object"
    },
    "TikTokDistrict": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "parentName": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "id",
        "name",
        "parentName"
      ],
      "type": "object"
    },
    "TikTokEffectClassification": {
      "additionalProperties": false,
      "properties": {
        "creatorTypeCode": {
          "type": [
            "integer",
            "null"
          ]
        },
        "sourceCode": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "creatorTypeCode",
        "sourceCode"
      ],
      "type": "object"
    },
    "TikTokEffectCreation": {
      "additionalProperties": false,
      "properties": {
        "isEffectHouse": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "isExternalProducer": {
          "type": [
            "boolean",
            "null"
          ]
        }
      },
      "required": [
        "isEffectHouse",
        "isExternalProducer"
      ],
      "type": "object"
    },
    "TikTokEffectMetrics": {
      "additionalProperties": false,
      "properties": {
        "uses": {
          "type": [
            "integer",
            "null"
          ]
        },
        "views": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "uses",
        "views"
      ],
      "type": "object"
    },
    "TikTokEffectOwner": {
      "additionalProperties": false,
      "properties": {
        "avatar": {
          "anyOf": [
            {
              "$ref": "#/$defs/TikTokAsset"
            },
            {
              "type": "null"
            }
          ]
        },
        "displayName": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "id": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "isTopEffectDesigner": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "secUid": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "verification": {
          "$ref": "#/$defs/TikTokEffectOwnerVerification"
        }
      },
      "required": [
        "id",
        "secUid",
        "displayName",
        "avatar",
        "isTopEffectDesigner",
        "verification"
      ],
      "type": "object"
    },
    "TikTokEffectOwnerVerification": {
      "additionalProperties": false,
      "properties": {
        "typeCode": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "typeCode"
      ],
      "type": "object"
    },
    "TikTokEffectReference": {
      "additionalProperties": false,
      "properties": {
        "attributions": {
          "items": {
            "$ref": "#/$defs/TikTokUnspecified"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "children": {
          "items": {
            "$ref": "#/$defs/TikTokUnspecified"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "classification": {
          "$ref": "#/$defs/TikTokEffectClassification"
        },
        "creation": {
          "$ref": "#/$defs/TikTokEffectCreation"
        },
        "description": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "effectId": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "icon": {
          "anyOf": [
            {
              "$ref": "#/$defs/TikTokAsset"
            },
            {
              "type": "null"
            }
          ]
        },
        "id": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "isTopEffect": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "linkedAnchors": {
          "items": {
            "$ref": "#/$defs/TikTokUnspecified"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "metrics": {
          "$ref": "#/$defs/TikTokEffectMetrics"
        },
        "name": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "owner": {
          "anyOf": [
            {
              "$ref": "#/$defs/TikTokEffectOwner"
            },
            {
              "type": "null"
            }
          ]
        },
        "publishedAt": {
          "format": "date-time",
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "resourceId": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "tags": {
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "triggers": {
          "items": {
            "$ref": "#/$defs/TikTokEffectTrigger"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "url": {
          "format": "uri",
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "id",
        "effectId",
        "resourceId",
        "name",
        "description",
        "publishedAt",
        "url",
        "isTopEffect",
        "tags",
        "owner",
        "icon",
        "metrics",
        "classification",
        "creation",
        "triggers",
        "children",
        "attributions",
        "linkedAnchors"
      ],
      "type": "object"
    },
    "TikTokEffectTrigger": {
      "additionalProperties": false,
      "properties": {
        "actionCodes": {
          "items": {
            "type": "integer"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "type": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "type",
        "actionCodes"
      ],
      "type": "object"
    },
    "TikTokHashtagReference": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "url": {
          "format": "uri",
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "id",
        "name",
        "url"
      ],
      "type": "object"
    },
    "TikTokInteractionSticker": {
      "additionalProperties": false,
      "properties": {
        "hashtag": {
          "anyOf": [
            {
              "$ref": "#/$defs/TikTokHashtagReference"
            },
            {
              "type": "null"
            }
          ]
        },
        "index": {
          "type": [
            "integer",
            "null"
          ]
        },
        "isTextHashtag": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "materialIndex": {
          "type": [
            "integer",
            "null"
          ]
        },
        "positions": {
          "items": {
            "$ref": "#/$defs/TikTokStickerPosition"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "text": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "typeCode": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "typeCode",
        "index",
        "materialIndex",
        "text",
        "hashtag",
        "isTextHashtag",
        "positions"
      ],
      "type": "object"
    },
    "TikTokLocationAddress": {
      "additionalProperties": false,
      "properties": {
        "city": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "cityCode": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "countryCode": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "district": {
          "anyOf": [
            {
              "$ref": "#/$defs/TikTokDistrict"
            },
            {
              "type": "null"
            }
          ]
        },
        "fallback": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "formatted": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "regionCode": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "formatted",
        "fallback",
        "city",
        "cityCode",
        "regionCode",
        "countryCode",
        "district"
      ],
      "type": "object"
    },
    "TikTokLocationClassification": {
      "additionalProperties": false,
      "properties": {
        "backendType": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "className": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "code": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "detailType": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "hierarchy": {
          "items": {
            "minLength": 1,
            "type": "string"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "levelCode": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "serviceCategory": {
          "$ref": "#/$defs/TikTokServiceCategory"
        },
        "sourceCode": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "code",
        "className",
        "detailType",
        "sourceCode",
        "levelCode",
        "backendType",
        "hierarchy",
        "serviceCategory"
      ],
      "type": "object"
    },
    "TikTokLocationCommerce": {
      "additionalProperties": false,
      "properties": {
        "hasProductShelf": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "isClaimed": {
          "type": [
            "boolean",
            "null"
          ]
        }
      },
      "required": [
        "hasProductShelf",
        "isClaimed"
      ],
      "type": "object"
    },
    "TikTokLocationMetrics": {
      "additionalProperties": false,
      "properties": {
        "favorites": {
          "type": [
            "integer",
            "null"
          ]
        },
        "reviews": {
          "type": [
            "integer",
            "null"
          ]
        },
        "videos": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "required": [
        "favorites",
        "reviews",
        "videos"
      ],
      "type": "object"
    },
    "TikTokLocationParent": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "id",
        "name"
      ],
      "type": "object"
    },
    "TikTokLocationRating": {
      "additionalProperties": false,
      "properties": {
        "hasRating": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "maxScore": {
          "type": [
            "number",
            "null"
          ]
        },
        "score": {
          "type": [
            "number",
            "null"
          ]
        },
        "source": {
          "$ref": "#/$defs/TikTokRatingSource"
        }
      },
      "required": [
        "score",
        "maxScore",
        "hasRating",
        "source"
      ],
      "type": "object"
    },
    "TikTokLocationReference": {
      "additionalProperties": false,
      "properties": {
        "address": {
          "$ref": "#/$defs/TikTokLocationAddress"
        },
        "category": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "classification": {
          "$ref": "#/$defs/TikTokLocationClassification"
        },
        "commerce": {
          "$ref": "#/$defs/TikTokLocationCommerce"
        },
        "coordinates": {
          "$ref": "#/$defs/TikTokCoordinates"
        },
        "externalUrl": {
          "format": "uri",
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "id": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "metrics": {
          "$ref": "#/$defs/TikTokLocationMetrics"
        },
        "name": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "openingHours": {
          "$ref": "#/$defs/TikTokOpeningHours"
        },
        "parent": {
          "anyOf": [
            {
              "$ref": "#/$defs/TikTokLocationParent"
            },
            {
              "type": "null"
            }
          ]
        },
        "priceLevel": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "rating": {
          "$ref": "#/$defs/TikTokLocationRating"
        },
        "source": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "url": {
          "format": "uri",
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "id",
        "name",
        "category",
        "source",
        "url",
        "address",
        "coordinates",
        "parent",
        "classification",
        "metrics",
        "rating",
        "priceLevel",
        "externalUrl",
        "openingHours",
        "commerce"
      ],
      "type": "object"
    },
    "TikTokLyricAsset": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "typeCode": {
          "type": [
            "integer",
            "null"
          ]
        },
        "url": {
          "format": "uri",
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "id",
        "typeCode",
        "url"
      ],
      "type": "object"
    },
    "TikTokMatchedTrack": {
      "additionalProperties": false,
      "properties": {
        "artistName": {
          "minLength": 1,
          "type": [
            "string",
            "null"
          ]
        },
        "artists": {
          "items": {
            "$ref": "#/$defs/TikTokProfileReference"
          },
          "type": [
            "array",
            "null"
          ]
        },
        "chorus": {
          "$ref": "#/$defs/TikTokMusicPreview"
        },
        "cover": {
          "anyOf": [
            {
              "$ref": "#/$defs/TikTokAsset"
            },
            {
 

# --- truncated at 32 KB (79 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/openhandle/refs/heads/main/json-schema/openhandle-tik-tok-post-schema.json

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-post"
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.