# TikTok API

Public TikTok profiles, videos, and engagement data.

Auth: `Authorization: Bearer <SOCIFY_KEY>`  
HTML: https://trysocify.com/docs/api/tiktok  
Platform file: https://trysocify.com/llms-tiktok.txt  
OpenAPI: https://trysocify.com/openapi.json

## Endpoints (12)

- [Profile](#profile) — `GET /api/v1/tiktok/profile` (1 credit per request)
- [Videos](#videos) — `GET /api/v1/tiktok/videos` (1 credit per request)
- [Comments](#comments) — `GET /api/v1/tiktok/comments` (1 credit per request)
- [Hashtag](#hashtag) — `GET /api/v1/tiktok/hashtag` (1 credit per request)
- [Hashtag Videos](#hashtag-videos) — `GET /api/v1/tiktok/hashtag-videos` (1 credit per request)
- [Search](#search) — `GET /api/v1/tiktok/search` (1 credit per request)
- [Followers](#followers) — `GET /api/v1/tiktok/followers` (1 credit per request)
- [Following](#following) — `GET /api/v1/tiktok/following` (1 credit per request)
- [Video](#video) — `GET /api/v1/tiktok/video` (1 credit per request)
- [Liked](#liked) — `GET /api/v1/tiktok/liked` (1 credit per request)
- [Playlists](#playlists) — `GET /api/v1/tiktok/playlists` (1 credit per request)
- [Replies](#replies) — `GET /api/v1/tiktok/replies` (1 credit per request)

### Profile

`GET /api/v1/tiktok/profile`

Fetch a public TikTok profile by username: bio, stats, verification, and avatar.

Credits: 1 credit per request

**Parameters**

- `username` (required) — TikTok username without @. Example: `daviddobrik`.

**Docs:** [https://trysocify.com/docs/api/tiktok/profile.md](https://trysocify.com/docs/api/tiktok/profile.md) · HTML: https://trysocify.com/docs/api/tiktok/profile

```bash
curl -sS 'https://trysocify.com/api/v1/tiktok/profile?username=daviddobrik' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Videos

`GET /api/v1/tiktok/videos`

Fetch recent public videos for a username.

Credits: 1 credit per request

**Parameters**

- `username` (required) — TikTok username without @. Example: `lilyachty`.
- `cursor` (optional) — Pagination cursor from a previous response.

**Docs:** [https://trysocify.com/docs/api/tiktok/videos.md](https://trysocify.com/docs/api/tiktok/videos.md) · HTML: https://trysocify.com/docs/api/tiktok/videos

```bash
curl -sS 'https://trysocify.com/api/v1/tiktok/videos?username=lilyachty' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Comments

`GET /api/v1/tiktok/comments`

Fetch comments for a video. Provide exactly one of id or url.

Credits: 1 credit per request

**Parameters**

- `id` (optional) — Video id (not comment id). Exactly one of id or url. Prefer id. Example: `7165262254722534698`.
- `url` (optional) — Full TikTok video URL (alternative to id). Example: `https://www.tiktok.com/@daviddobrik/video/7165262254722534698`.
- `cursor` (optional) — Pagination cursor from a previous response.

**Docs:** [https://trysocify.com/docs/api/tiktok/comments.md](https://trysocify.com/docs/api/tiktok/comments.md) · HTML: https://trysocify.com/docs/api/tiktok/comments

```bash
curl -sS 'https://trysocify.com/api/v1/tiktok/comments?id=7165262254722534698' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Hashtag

`GET /api/v1/tiktok/hashtag`

Fetch public metadata for a TikTok hashtag: id, name, video count, and view count when available.

Credits: 1 credit per request

**Parameters**

- `name` (required) — Hashtag name without #. Example: `comedy`.

**Docs:** [https://trysocify.com/docs/api/tiktok/hashtag.md](https://trysocify.com/docs/api/tiktok/hashtag.md) · HTML: https://trysocify.com/docs/api/tiktok/hashtag

```bash
curl -sS 'https://trysocify.com/api/v1/tiktok/hashtag?name=comedy' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Hashtag Videos

`GET /api/v1/tiktok/hashtag-videos`

Fetch videos for a hashtag. Provide exactly one of id (from Hashtag) or name.

Credits: 1 credit per request

**Parameters**

- `name` (optional) — Exactly one of name or id. Prefer name. Hashtag without #. Example: `comedy`.
- `id` (optional) — Hashtag id from Hashtag (not video id; alternative to name). Example: `1606334392378370`.
- `cursor` (optional) — Pagination cursor from a previous response.

**Docs:** [https://trysocify.com/docs/api/tiktok/hashtag-videos.md](https://trysocify.com/docs/api/tiktok/hashtag-videos.md) · HTML: https://trysocify.com/docs/api/tiktok/hashtag-videos

```bash
curl -sS 'https://trysocify.com/api/v1/tiktok/hashtag-videos?name=comedy' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Search

`GET /api/v1/tiktok/search`

Search public TikTok users by query. Returns matching profiles only (not videos or other content).

Credits: 1 credit per request

**Parameters**

- `query` (required) — Search text. Example: `daviddobrik`.
- `cursor` (optional) — Pagination cursor from a previous response.

**Docs:** [https://trysocify.com/docs/api/tiktok/search.md](https://trysocify.com/docs/api/tiktok/search.md) · HTML: https://trysocify.com/docs/api/tiktok/search

```bash
curl -sS 'https://trysocify.com/api/v1/tiktok/search?query=daviddobrik' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Followers

`GET /api/v1/tiktok/followers`

Fetch a page of followers for a username.

Credits: 1 credit per request

**Parameters**

- `username` (required) — TikTok username without @. Example: `lilyachty`.
- `cursor` (optional) — Pagination cursor from a previous response.

**Docs:** [https://trysocify.com/docs/api/tiktok/followers.md](https://trysocify.com/docs/api/tiktok/followers.md) · HTML: https://trysocify.com/docs/api/tiktok/followers

```bash
curl -sS 'https://trysocify.com/api/v1/tiktok/followers?username=lilyachty' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Following

`GET /api/v1/tiktok/following`

Fetch a page of accounts a username follows.

Credits: 1 credit per request

**Parameters**

- `username` (required) — TikTok username without @. Example: `lilyachty`.
- `cursor` (optional) — Pagination cursor from a previous response.

**Docs:** [https://trysocify.com/docs/api/tiktok/following.md](https://trysocify.com/docs/api/tiktok/following.md) · HTML: https://trysocify.com/docs/api/tiktok/following

```bash
curl -sS 'https://trysocify.com/api/v1/tiktok/following?username=lilyachty' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Video

`GET /api/v1/tiktok/video`

Fetch public details for a single TikTok video. Provide exactly one of url or id.

Credits: 1 credit per request

**Parameters**

- `url` (optional) — Exactly one of url or id. Prefer full video URL. Example: `https://www.tiktok.com/@daviddobrik/video/7165262254722534698`.
- `id` (optional) — Video id (alternative to url). Example: `7165262254722534698`.

**Docs:** [https://trysocify.com/docs/api/tiktok/video.md](https://trysocify.com/docs/api/tiktok/video.md) · HTML: https://trysocify.com/docs/api/tiktok/video

```bash
curl -sS 'https://trysocify.com/api/v1/tiktok/video?url=https%3A%2F%2Fwww.tiktok.com%2F%40daviddobrik%2Fvideo%2F7165262254722534698' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Liked

`GET /api/v1/tiktok/liked`

Fetch liked videos for a username when that account makes likes public. Many profiles hide liked videos; those requests fail (likes are private).

Credits: 1 credit per request

**Parameters**

- `username` (required) — TikTok username without @. Account must show likes publicly. Example: `lilyachty`.
- `cursor` (optional) — Pagination cursor from a previous response.

**Docs:** [https://trysocify.com/docs/api/tiktok/liked.md](https://trysocify.com/docs/api/tiktok/liked.md) · HTML: https://trysocify.com/docs/api/tiktok/liked

```bash
curl -sS 'https://trysocify.com/api/v1/tiktok/liked?username=lilyachty' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Playlists

`GET /api/v1/tiktok/playlists`

Fetch public playlists for a username.

Credits: 1 credit per request

**Parameters**

- `username` (required) — TikTok username without @. Example: `ibaillanos`.
- `cursor` (optional) — Pagination cursor from a previous response.

**Docs:** [https://trysocify.com/docs/api/tiktok/playlists.md](https://trysocify.com/docs/api/tiktok/playlists.md) · HTML: https://trysocify.com/docs/api/tiktok/playlists

```bash
curl -sS 'https://trysocify.com/api/v1/tiktok/playlists?username=ibaillanos' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

### Replies

`GET /api/v1/tiktok/replies`

Fetch replies to a comment. Provide media_id (video id) and id (comment id).

Credits: 1 credit per request

**Parameters**

- `media_id` (required) — Video id the parent comment belongs to (not a hashtag or comment id). Example: `7165262254722534698`.
- `id` (required) — Parent comment id (not the video id). Example: `7165265882552828718`.
- `cursor` (optional) — Pagination cursor from a previous response.

**Docs:** [https://trysocify.com/docs/api/tiktok/replies.md](https://trysocify.com/docs/api/tiktok/replies.md) · HTML: https://trysocify.com/docs/api/tiktok/replies

```bash
curl -sS 'https://trysocify.com/api/v1/tiktok/replies?media_id=7165262254722534698&id=7165265882552828718' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```