API Documentation

Welcome to the SocialAPI documentation. Learn how to integrate TikTok data into your applications.

curl -X GET "https://api.socialapi.store/api/v1/user/info?username=therock" \
  -H "X-API-Key: YOUR_API_KEY"

Authentication

All API requests require authentication using your API key. Include it in the request header:

X-API-Key: tk_live_xxxxxxxxxxxxx

You can also use the Authorization: Bearer header format.

Rate Limiting

API requests are rate limited based on your plan:

• Default: 100 requests per minute
• Pro: 500 requests per minute
• Enterprise: Custom limits

When you exceed the rate limit, you'll receive a 429 Too Many Requests response.

Credits

Each API request consumes credits based on the endpoint:

API Endpoints

curl -X GET "https://api.socialapi.store/api/v1/user/info?username=therock" \
  -H "X-SocialAPI-Key: your_api_key"

{
  "success": true,
  "data": {
    "user": {
      "id": "123456789",
      "uniqueId": "therock",
      "nickname": "The Rock",
      "avatarLarger": "https://...",
      "signature": "Actor, Producer...",
      "verified": true,
      "followerCount": 72000000,
      "followingCount": 500,
      "heartCount": 450000000,
      "videoCount": 250
    }
  }
}

curl -X GET "https://api.socialapi.store/api/v1/user/videos?username=therock&count=10" \
  -H "X-SocialAPI-Key: your_api_key"

{
  "success": true,
  "data": {
    "videos": [...],
    "hasMore": true,
    "cursor": "1234567890"
  }
}

curl -X GET "https://api.socialapi.store/api/v1/user/liked?username=therock" \
  -H "X-SocialAPI-Key: your_api_key"

{
  "success": true,
  "data": {
    "videos": [...],
    "hasMore": true
  }
}

Error Handling

The API uses standard HTTP status codes to indicate success or failure: