# LamaTok

> Unofficial TikTok Private API. Fault-tolerant RESTful API for TikTok analytics and SMM automation. Get users, followers, posts, stories, hashtags, locations. Automate publications, stories, direct messages. From $0.60 per 1,000 requests.

## Docs

- [API Reference](https://api.lamatok.com/docs): Interactive Swagger UI with all endpoints
- [ReDoc](https://api.lamatok.com/redoc): Alternative API documentation
- [MCP Server](https://www.npmjs.com/package/lamatok-mcp): Use LamaTok from Claude, Cursor, OpenAI Codex, Zed, Windsurf, and other AI assistants — `npx -y lamatok-mcp`

## Features

- Get public data of user profiles, posts, stories, highlights, followers and following users for analytics
- Get public email and phone number from business profiles for SMM
- Get public data of post, story, album, reels with the ability to download content for analytics
- Get public data of hashtag and location, as well as a list of posts for them for SMM
- Get all comments on a post and a list of users who liked it for analytics
- Management of mobile devices, solving captcha and challenge resolver
- Login by username and password, sessionid and support 2FA
- Managing messages and threads for Direct and attach files
- Download and upload a photo, video, reels, albums and stories
- Work with users, posts, comments, insights, collections, location and hashtag
- Insights by account, posts and stories
- Like, following, commenting, editing account (Bio) and more

## API Categories

### v1/user (8 endpoints)
User profiles, followers, following. Includes:
- Get user profile by username or ID
- Get user followers and following lists
- Get user media feed

### v1/media (8 endpoints)
Posts, reels, comments. Includes:
- Get media info and details
- Get media comments and likers
- Download media content
- Upload photos, videos, reels

### v1/hashtag (2 endpoints)
Hashtag search and posts. Includes:
- Search hashtags
- Get posts by hashtag

## Key Features

- 91% uptime, fault-tolerant architecture
- Free proxy servers and device pools included
- Account pool provided — no need for your own TikTok accounts
- Prevents blocking by handling TikTok rate limiting
- Pay-per-request model, no monthly subscription
- Funds never expire

## Pricing

Pay-as-you-go plans based on deposit amount:

| Plan | Price per request | Min deposit |
|------|------------------|-------------|
| Start | $0.02 | $20 |
| Basic | $0.0025 | $50 |
| Standard | $0.001 | $100 |
| Premium | $0.0006 | $300 |

- 100 free requests on signup
- We charge for any successful response (200, 403, 404)
- For 50x server errors we do not charge
- Funds never expire
- Payment methods: Visa/MC, USDT (TRC20, ERC20, BEP20)

## FAQ

### Do you have a plan to make over a million requests?
Yes, you can write to us by email (support@lamatok.com) or Telegram (https://telegram.me/LamaTokSupportBot).

### Will my funds expire at the end of the month?
No, we only charge for successful requests. If you stop making requests your balance will remain unchanged.

### What requests do you charge for?
We charge for any successful response (such as 200, 403 and 404). For 50x errors we do not charge.

### Do I need to use my own TikTok account to get data?
No, we provide our own accounts. You don't need your own TikTok accounts.

## AI Assistants / MCP

### LamaTok MCP Server
LamaTok is available as a Model Context Protocol (MCP) server, so any MCP-compatible AI assistant — Claude Code, Claude Desktop, Cursor, OpenAI Codex, Zed, Windsurf — can call LamaTok endpoints directly.

The server is published on npm as `lamatok-mcp`. It runs locally as a stdio process (Node.js >= 20). On startup it fetches the live LamaTok OpenAPI spec from `https://api.lamatok.com/openapi.json` and auto-generates one MCP tool per non-deprecated GET endpoint — about 19 tools across `v1/user` (9), `v1/media` (8), and `v1/hashtag` (2). As LamaTok grows, new endpoints become tools automatically without releasing a new version of `lamatok-mcp`.

- npm: https://www.npmjs.com/package/lamatok-mcp
- GitHub: https://github.com/subzeroid/lamatok-mcp
- License: MIT

#### Install for Claude Code
```bash
claude mcp add lamatok -e LAMATOK_KEY=your-api-key -- npx -y lamatok-mcp
```

#### Install for Claude Desktop / Cursor / Windsurf
```json
{
  "mcpServers": {
    "lamatok": {
      "command": "npx",
      "args": ["-y", "lamatok-mcp"],
      "env": { "LAMATOK_KEY": "your-api-key" }
    }
  }
}
```

#### Install for OpenAI Codex (append to `~/.codex/config.toml`)
```toml
[mcp_servers.lamatok]
command = "npx"
args = ["-y", "lamatok-mcp"]

[mcp_servers.lamatok.env]
LAMATOK_KEY = "your-api-key"
```

#### Install for Zed (`~/.config/zed/settings.json`)
```json
{
  "context_servers": {
    "lamatok": {
      "command": "npx",
      "args": ["-y", "lamatok-mcp"],
      "env": { "LAMATOK_KEY": "your-api-key" }
    }
  }
}
```

#### Configuration
- `LAMATOK_KEY` (required) — your LamaTok access key, sent as `x-access-key` header
- `LAMATOK_TAGS` (optional) — comma-separated whitelist of tags (e.g. `v1/user,v1/media`) to limit which tools are exposed
- `LAMATOK_EXCLUDE_TAGS` (optional) — additional tags to exclude (defaults already exclude `Legacy`, `System`, `/sys`)
- `LAMATOK_TIMEOUT_MS` (optional) — per-request timeout, default 30000

#### Pricing
The MCP server is free (MIT). LamaTok usage is charged the same as direct API calls — pay-as-you-go, plans from $0.02 (Start) to $0.0006 (Premium) per request. 100 free requests on signup. No subscription required.

## Support

- Email: support@lamatok.com
- Telegram: https://telegram.me/LamaTokSupportBot
- Status page: https://lamatok.com/status

## Legal

- [Terms of Service](https://lamatok.com/help/terms-of-service)
- [Privacy Policy](https://lamatok.com/help/privacy-policy)
- [Refund Policy](https://lamatok.com/help/refund-policy)