Get TikTok Profile

{
  "user": {
    "id": "6659752019493208069", // TikTok's internal user ID
    "shortId": "", // Short ID if available
    "uniqueId": "stoolpresidente", // The handle/username
    "nickname": "Dave Portnoy", // Display name
    "avatarLarger": "https://p16-sign-va.tiktokcdn.com/...jpeg", // URL to larger avatar
    "avatarMedium": "https://p16-sign-va.tiktokcdn.com/...jpeg", // URL to medium avatar
    "avatarThumb": "https://p16-sign-va.tiktokcdn.com/...jpeg", // URL to thumbnail avatar
    "signature": "El Presidente/Barstool Sports Founder.", // User's bio/signature
    "createTime": 1550594547, // Timestamp of account creation
    "verified": true, // Whether the account is verified
    "secUid": "MS4wLjABAAAAINC_ElRR-l1RCcnEjOZhNO-9wOzAMf-YHXqRY8vvG9bEhMRa6iu23TaE3JPZYXBD", // Secured User ID
    "ftc": false,
    "relation": 0,
    "openFavorite": false,
    "bioLink": { // Optional: details about the link in bio
      "link": "https://www.barstoolsports.com/bios/Surviving-Barstool",
      "risk": 0
    },
    "commentSetting": 0,
    "commerceUserInfo": { "commerceUser": false },
    "duetSetting": 0,
    "stitchSetting": 0,
    "privateAccount": false, // Whether the account is private
    "secret": false,
    "isADVirtual": false,
    "roomId": "",
    "uniqueIdModifyTime": 0,
    "ttSeller": false,
    "region": "US", // User's region
    "downloadSetting": 0,
    "profileTab": {
      "showMusicTab": false,
      "showQuestionTab": false,
      "showPlayListTab": true
    },
    "followingVisibility": 1,
    "recommendReason": "",
    "nowInvitationCardUrl": "",
    "nickNameModifyTime": 0,
    "isEmbedBanned": false,
    "canExpPlaylist": true,
    "profileEmbedPermission": 1,
    "language": "en", // Profile language
    "eventList": [],
    "suggestAccountBind": false,
    "isOrganization": 0
  },
  "stats": {
    "followerCount": 4100000, // Number of followers
    "followingCount": 74, // Number of accounts followed
    "heart": 190400000, // Total hearts received (legacy or alternative field)
    "heartCount": 190400000, // Total hearts received
    "videoCount": 2017, // Number of videos posted
    "diggCount": 0, // Number of diggs (likes) given - may not always be populated
    "friendCount": 52 // Number of friends
  },
  "itemList": [] // List of recent items/videos, structure might vary or be empty
}

{
  "error": "'handle' parameter is required and must be a non-empty string."
}

{
  "error": "API key is invalid or missing."
}

{
  "error": "Insufficient credits. Please top up your account."
}

{
  "error": "TikTok profile not found for handle: [handle]"
}

{
  "error": "An unexpected server error occurred while fetching the TikTok profile: [specific error message]"
}

{
  "error": "Received invalid data format from profile service."
}

{
  "error": "Rate limit exceeded with the profile service. Please try again later."
}

curl -X POST \
  https://app.dumplingai.com/api/v1/get-tiktok-profile \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "handle": "stoolpresidente" }'

async function getTikTokProfile(apiKey, handle) {
  const url = 'https://app.dumplingai.com/api/v1/get-tiktok-profile';
  const options = {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${apiKey}`
    },
    body: JSON.stringify({ handle })
  };

  try {
    const response = await fetch(url, options);
    const data = await response.json();
    if (!response.ok) {
      console.error(`Error: ${response.status}`, data);
      return null;
    }
    console.log(data);
    return data;
  } catch (error) {
    console.error('Failed to fetch TikTok profile:', error);
    return null;
  }
}

// Example usage:
// getTikTokProfile('YOUR_API_KEY', 'stoolpresidente');