API Documentation

Welcome to the SocialAPI documentation. Learn how to integrate TikTok data into your applications with our simple REST API.

Quickstart

Get up and running in minutes

Endpoints

Browse all available API endpoints

Authentication

Learn how to authenticate requests

Quickstart

Get started with SocialAPI in three steps.

1. Get your API Key

Create an account and generate an API key from your dashboard.

2. Make your first request

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

3. Handle the response

All responses are in JSON format with a consistent structure including a success boolean and a data object.

Authentication

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

X-API-Key: sk_live_xxxxxxxxxxxxx

You can also use the Authorization: Bearer header format.

API Endpoints

Browse all available endpoints organized by category.

GET
/api/v1/user/info
1 extra request
Get User Info
Get detailed information about a TikTok user including follower count, bio, and profile data.

Parameters

username
required
string— TikTok username

Example Request

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

Example Response

{
  "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
    }
  }
}
GET
/api/v1/user/videos
2 extra requests
Get User Videos
Get a list of videos posted by a TikTok user.

Parameters

username
required
string— TikTok username
count
optional
number— Number of videos to return (default: 30, max: 100)
cursor
optional
string— Pagination cursor

Example Request

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

Example Response

{
  "success": true,
  "data": {
    "videos": [...],
    "hasMore": true,
    "cursor": "1234567890"
  }
}
GET
/api/v1/user/liked
2 extra requests
Get User Liked Videos
Get videos liked by a TikTok user (if public).

Parameters

username
required
string— TikTok username
count
optional
number— Number of videos to return (default: 30)

Example Request

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

Example Response

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

Rate Limiting

API requests are rate limited based on your subscription plan:

Starter
300 requests/day
Pro
2,000 requests/day
Business
10,000 requests/day

Your daily plan quota is consumed first. If you have extra request balance, requests beyond the quota can still succeed until that overflow balance is used up.

Extra Request Balance

Extra request balance is only consumed after you exceed your daily plan quota. Different endpoints consume different amounts:

1 extra request
Basic info endpoints (user info, hashtag info, sound info)
2 extra requests
List endpoints (videos, comments, followers, hashtag videos)
3 extra requests
Search endpoints

Error Handling

The API uses standard HTTP status codes:

200
Success
400
Bad Request — Invalid parameters
401
Unauthorized — Invalid or missing API key
402
Payment Required — Daily quota exhausted and no extra request balance available
429
Too Many Requests — Per-minute API key rate limit exceeded
500
Internal Server Error

FAQ

What data can I access?

You can access TikTok user profiles, videos, comments, hashtags, trending content, sounds, and search results.

Do I need a TikTok account?

No. SocialAPI handles all the data fetching. You just need an API key.

What format are responses in?

All responses are JSON with a consistent structure: a `success` boolean and a `data` object.

Can I use the API in production?

Yes. Our API is designed for production use with 99.9% uptime SLA on paid plans.

Troubleshooting

401 Unauthorized

Check that your API key is correct and included in the X-API-Key header. Make sure there are no extra spaces.

429 Too Many Requests

You've hit the per-minute API key rate limit. Wait a moment before retrying. If you are out of daily quota, add extra request balance or upgrade your plan.

Empty response data

The user or content may not exist or may be private. Verify the username/URL is correct.

Timeout errors

Some requests may take longer for large datasets. Try reducing the count parameter or adding pagination.