User Lookup Video Info TikMatrix API Docs Story Viewer Url Tracker Video Downloader

📚 API Documentation

TikTok User & Video API Reference

Join Our Telegram Channel

🚀 Introduction

Welcome to the TikTok User Finder API documentation. Our API provides programmatic access to TikTok user profiles and video information. All endpoints return JSON responses and support CORS for easy integration.

Note: No API key is required — these endpoints are open. They are rate limited per IP, see Rate Limits below.

👤 User API

GET /api/user

Retrieves detailed information about a TikTok user including profile data, statistics, and metadata.

Request Parameters

Parameter Type Required Description
username string Required TikTok username (with or without @ symbol)

Example Request

GET /api/user?username=tiktok

cURL Example

curl -X GET "https://user.tikmatrix.com/api/user?username=tiktok"

JavaScript Example

fetch('https://user.tikmatrix.com/api/user?username=tiktok')
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

Response Format

{
  "profile": {
    "Username": "@tiktok",
    "Nickname": "TikTok",
    "Avatar URL": "https://...",
    "Country": "United States",
    "Language": "English",
    "About": "Make Your Day",
    "Bio Link": "https://...",
    "User ID": "123456789",
    "SecUID": "SEC_UID_...",
    "Account Created": "2020-01-01",
    "Nickname Last Modified": "2023-01-01",
    "Username Last Modified": "2023-01-01"
  },
  "stats": {
    "Followers": 1000000,
    "Following": 100,
    "Hearts": 5000000,
    "Videos": 500,
    "Friends": 50
  },
}

Response Fields

Field Type Description
profile.Username string TikTok username with @ symbol
profile.Nickname string Display name of the user
profile.Avatar URL string URL to user's avatar image
stats.Followers number Total number of followers
stats.Following number Total number of accounts following
stats.Hearts number Total likes received across all videos
stats.Videos number Total number of videos posted

Error Responses

// Missing username parameter
{
  "error": "username parameter is required"
}

// Invalid username format
{
  "error": "Invalid username format"
}

// User not found
{
  "error": "User not found"
}

🎥 Video API

GET /api/video

Retrieves detailed information about a TikTok video including metadata, statistics, author information, and music details.

Request Parameters

Parameter Type Required Description
url string Required Full TikTok video URL (e.g., https://www.tiktok.com/@username/video/1234567890)

Example Request

GET /api/video?url=https://www.tiktok.com/@username/video/1234567890

cURL Example

curl -X GET "https://user.tikmatrix.com/api/video?url=https://www.tiktok.com/@username/video/1234567890"

JavaScript Example

const videoUrl = encodeURIComponent('https://www.tiktok.com/@username/video/1234567890');
fetch(`https://user.tikmatrix.com/api/video?url=${videoUrl}`)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

Response Format

{
  "videoId": "1234567890",
  "desc": "Video description text",
  "createTime": "2024-01-01T00:00:00Z",
  "video": {
    "duration": 30,
    "width": 1080,
    "height": 1920,
    "cover": "https://..."
  },
  "author": {
    "username": "username",
    "nickname": "Display Name",
    "avatar": "https://...",
    "userId": "123456789",
    "secUid": "SEC_UID_...",
    "verified": true
  },
  "stats": {
    "playCount": 1000000,
    "diggCount": 50000,
    "commentCount": 1000,
    "shareCount": 5000,
    "collectCount": 2000
  },
  "music": {
    "title": "Song Title",
    "author": "Artist Name",
    "duration": 30
  },
  "challenges": [
    {
      "title": "#challenge1"
    }
  ]
}

Response Fields

Field Type Description
videoId string Unique identifier for the video
desc string Video description/caption
createTime string ISO 8601 timestamp of when video was created
video.duration number Video duration in seconds
video.cover string URL to video cover image
author.username string Video author's username
author.verified boolean Whether the author is verified
stats.playCount number Number of video views
stats.diggCount number Number of likes
stats.commentCount number Number of comments
stats.shareCount number Number of shares
music.title string Title of the music used in video
challenges array Array of hashtag challenges associated with video

Error Responses

// Missing URL parameter
{
  "error": "url parameter is required. Format: https://www.tiktok.com/@username/video/videoId"
}

// Invalid URL format
{
  "error": "Invalid video URL format. Expected: https://www.tiktok.com/@username/video/videoId"
}

// Video not found
{
  "error": "Video not found or unavailable"
}

⚡ Rate Limits & Caching

These endpoints are open, so fair usage is enforced per client IP at the edge:

💬 Support & Contact

Need help or have questions? We're here to assist you!