Douyin Account Profile Lookup (Batch, up to 50)

{
  "type": "object",
  "required": [
    "sec_user_ids"
  ],
  "properties": {
    "sec_user_ids": {
      "type": "string",
      "examples": [
        "MS4wLjABAAAANXSltcLCzDGmdNFI2Q_QixVTr67NiYzjKOIP5s03CAE,MS4wLjABAAAAW9FWcqS7RdQAWPd2AA5fL_ilmqsIFUCQ_Iym6Yh9_cUa6ZRqVLjVQSUjlHrfXY1Y"
      ],
      "description": "One or more Douyin account sec_user_id values, separated by commas (up to 50)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "uid": {
            "type": "string",
            "description": "The account's own internal numeric id, as returned by the platform."
          },
          "sec_uid": {
            "type": "string",
            "description": "The account's own permanent id -- the same value used as input."
          },
          "nickname": {
            "type": "string",
            "description": "The account's own public display name."
          },
          "short_id": {
            "type": "string",
            "description": "A shorter numeric id also displayed on the account's public profile."
          },
          "signature": {
            "type": "string",
            "description": "The account's own public bio text. Observed empty on one of two real accounts."
          },
          "unique_id": {
            "type": "string",
            "description": "The account's own public handle (its @-style unique id)."
          },
          "avatar_small": {
            "type": "object",
            "properties": {
              "url_list": {
                "type": "array",
                "items": {
                  "type": "null"
                },
                "description": "Always an array of `null` in this tool's output -- only whether an avatar is set is confirmed by its presence, never the image URL itself."
              }
            },
            "description": "The account's small avatar. Its image URLs are withheld in this tool's output.",
            "additionalProperties": true
          },
          "avatar_thumb": {
            "type": "object",
            "properties": {
              "url_list": {
                "type": "array",
                "items": {
                  "type": "null"
                },
                "description": "Always an array of `null` in this tool's output -- only whether an avatar is set is confirmed by its presence, never the image URL itself."
              }
            },
            "description": "The account's thumbnail avatar. Its image URLs are withheld in this tool's output.",
            "additionalProperties": true
          },
          "store_region": {
            "type": "string",
            "description": "A coarse region code the platform itself displays on the public profile (e.g. 'cn-hn'), not a precise address."
          },
          "custom_verify": {
            "type": "string",
            "description": "Public verification badge text, when set. Empty string observed on both real accounts."
          },
          "verification_type": {
            "type": "number",
            "description": "The account's public verification badge type. 0 observed on both real accounts."
          },
          "commerce_user_level": {
            "type": "number",
            "description": "The account's public e-commerce seller tier. 0 observed on both real accounts."
          },
          "with_commerce_entry": {
            "type": "boolean",
            "description": "Whether the account's public profile shows a storefront entry point."
          },
          "enterprise_verify_reason": {
            "type": "string",
            "description": "Public enterprise-verification badge text, when set. Empty string observed on both real accounts."
          }
        },
        "additionalProperties": true
      },
      "description": "One entry per resolved account id, in the order requested."
    }
  },
  "description": "The batch of looked-up profiles, wrapped as `{ results: [...] }`. When the request's only id fails to resolve, the shaped output is `{}` (no `results` key at all) rather than an empty array -- confirmed against `invalid-single-id.json`, which still billed nothing for that outcome.",
  "additionalProperties": true
}