# TikHub — Social Media API & Data Infrastructure Platform

## Overview

TikHub is a comprehensive social media data infrastructure platform designed for developers, AI agents, researchers, and enterprises. It provides programmatic access to data from 16 major social media platforms through a unified API, along with an AI model gateway, pre-collected datasets, and AI agent integration tools.

Founded to simplify social media data access, TikHub serves use cases including social media analytics, influencer marketing, content intelligence, academic research, e-commerce monitoring, and AI training data collection.

## Platform Coverage

TikHub supports 16 social media platforms with 1000+ API endpoints:

| Platform | Data Types | Key Endpoints |
|----------|-----------|---------------|
| TikTok | Videos, users, comments, hashtags, music, search | User profile, video details, follower list, trending |
| Instagram | Posts, stories, reels, users, comments | Profile info, media details, hashtag posts |
| YouTube | Videos, channels, comments, playlists, search | Channel stats, video metadata, comment threads |
| Twitter/X | Tweets, users, followers, search, trends | User timeline, tweet details, search results |
| Douyin | Videos, users, comments, live streams | Chinese TikTok equivalent, full data access |
| Red Note (XHS) | Notes, users, comments | Xiaohongshu content and user data |
| Facebook | Posts, pages, groups | Public page and group data |
| Pinterest | Pins, boards, users | Pin details, board contents |
| Threads | Posts, users | Meta's Threads platform data |
| Bilibili | Videos, users, comments | Chinese video platform data |
| Weibo | Posts, users, comments | Chinese microblog data |
| Kuaishou | Videos, users | Chinese short video platform |
| Lemon8 | Posts, users | Lifestyle content platform |
| Snapchat | Stories, spotlight | Public content data |
| LinkedIn | Profiles, posts | Professional network data |
| Twitch | Streams, clips, users | Live streaming platform data |

## API Architecture

### Authentication
All API requests require an API key passed via the `Authorization` header:
```
Authorization: Bearer YOUR_API_KEY
```

### Base URL
```
https://api.tikhub.io
```

### Rate Limits
- Default: 3 requests per second (RPS)
- Upgradeable with RPS plans (5, 10, 20, 50, 100 RPS)
- Enterprise: Custom rate limits available

### Response Format
All endpoints return JSON with consistent structure:
```json
{
  "code": 200,
  "message": "success",
  "data": { ... }
}
```

## AI Gateway

TikHub's AI Gateway provides access to 75+ AI models at discounted rates (up to 83% off official pricing):

- **OpenAI**: GPT-4o, GPT-4 Turbo, GPT-3.5 Turbo
- **Anthropic**: Claude 3.5 Sonnet, Claude 3 Opus, Claude 3 Haiku
- **Google**: Gemini Pro, Gemini Flash
- **Meta**: Llama 3, Llama 2
- **Others**: Mistral, Qwen, Yi, DeepSeek, and more

Access via: https://ai.tikhub.io
Compatible with OpenAI SDK — just change the base URL.

## MCP Integration

TikHub provides 990+ Model Context Protocol (MCP) tools enabling AI agents to directly access social media data:

### Supported Clients
- Claude Desktop
- VS Code (with MCP extension)
- Cursor
- LangChain / LangGraph
- Any MCP-compatible client

### Transport Methods
- Stdio (local)
- Server-Sent Events (SSE)
- Streamable HTTP

### Quick Setup (Claude Desktop)
```json
{
  "mcpServers": {
    "tikhub": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-client", "https://mcp.tikhub.io/sse"]
    }
  }
}
```

## Datasets

Pre-collected social media datasets with 1B+ records:

- **Formats**: CSV, JSON, Parquet
- **Update frequency**: Daily/weekly depending on dataset
- **Use cases**: AI/ML training, market research, academic studies
- **Platforms covered**: TikTok, Instagram, YouTube, Twitter/X, and more

## Live Room API

Real-time livestream data via WebSocket connection:
- Danmaku (live comments/chat)
- Gift events
- Viewer count
- PK battle data
- Supported platforms: TikTok Live, Douyin Live

## Pricing

### Pay-as-You-Go (Primary Model)
| Daily Volume | Price per Request |
|-------------|------------------|
| 0 - 1,000 | $0.01 |
| 1,001 - 10,000 | $0.005 |
| 10,001 - 100,000 | $0.003 |
| 100,001+ | $0.001 |

### Free Tier
- ~50 free requests for new accounts
- Access to all endpoints
- No credit card required

### Enterprise
- Minimum: $3,000 one-time or $4,500 cumulative
- Custom endpoints and dedicated support
- Permanent fee waivers and bonus credits

### Payment Methods
- PayPal
- Alipay
- Cryptocurrency

## SDKs and Libraries

### Official Python SDK
```bash
pip install tikhub
```
Repository: https://github.com/TikHub/TikHub-API-Python-SDK

### REST API
Compatible with any HTTP client in any programming language.

## Common Use Cases

1. **Social Media Analytics**: Track engagement metrics, follower growth, content performance
2. **Influencer Marketing**: Discover influencers, analyze audience demographics, measure ROI
3. **Content Intelligence**: Monitor trends, analyze viral content patterns
4. **Academic Research**: Collect data for social media studies, sentiment analysis
5. **E-commerce Monitoring**: Track TikTok Shop products, social commerce trends
6. **AI Training Data**: Collect labeled social media data for ML model training
7. **Brand Monitoring**: Track brand mentions, sentiment, competitor activity

## Technical Requirements

- HTTPS required for all API calls
- JSON request/response format
- UTF-8 encoding
- API key required (obtain at https://user.tikhub.io)

## Support and Community

- **Documentation**: https://docs.tikhub.io
- **Discord Community**: https://discord.gg/aMEAS8Xsvz (response time: 10-30 min)
- **Email**: tikhub.io@proton.me (response time: 1-12 hours)
- **GitHub**: https://github.com/TikHub
- **Twitter/X**: https://x.com/TikHubio
- **LinkedIn**: https://www.linkedin.com/company/tikhub-io