# TikTok API

Get public TikTok profiles, videos, comments, followers, search, hashtags, trends, live data, and more through one stable API.

Status: Available in Test and Live environments. Last reviewed August 17, 2026.
Example: GET https://api.openhandle.dev/v1/tiktok/profiles/@{username}/posts
Every call is one request at the same price. All endpoints accept the freshness parameter.

## Endpoints (28 operations)

| Operation | Endpoint |
|---|---|
| Get a profile | GET /v1/tiktok/profiles/{identifier} |
| List profile videos | GET /v1/tiktok/profiles/{identifier}/posts |
| List liked posts | GET /v1/tiktok/profiles/{identifier}/liked-posts |
| List followers | GET /v1/tiktok/profiles/{identifier}/followers |
| List following | GET /v1/tiktok/profiles/{identifier}/following |
| List profile music | GET /v1/tiktok/profiles/{identifier}/music |
| List playlist posts | GET /v1/tiktok/profiles/{identifier}/playlists/{playlistId}/posts |
| Get a video | GET /v1/tiktok/posts/{identifier} |
| List comments | GET /v1/tiktok/posts/{identifier}/comments |
| List replies to a comment | GET /v1/tiktok/posts/{identifier}/comments/{commentId}/replies |
| Search profiles | GET /v1/tiktok/search/profiles?q={query} |
| Search posts | GET /v1/tiktok/search/posts?q={query} |
| Search hashtags | GET /v1/tiktok/search/hashtags?q={query} |
| Search locations | GET /v1/tiktok/search/locations?q={query} |
| Search music | GET /v1/tiktok/search/music?q={query} |
| Get a hashtag | GET /v1/tiktok/hashtags/{identifier} |
| List hashtag posts | GET /v1/tiktok/hashtags/{identifier}/posts |
| Get a location | GET /v1/tiktok/locations/{id} |
| List location posts | GET /v1/tiktok/locations/{id}/posts |
| Get music | GET /v1/tiktok/music/{id} |
| List music posts | GET /v1/tiktok/music/{id}/posts |
| List effect posts | GET /v1/tiktok/effects/{id}/posts |
| List trending categories | GET /v1/tiktok/trending/categories |
| List trending music | GET /v1/tiktok/trending/music |
| List trending posts | GET /v1/tiktok/trending/posts |

The complete 28-operation surface also covers liked posts, playlists, and effects. Every operation has its own generated page in the API reference.

Field reference: https://openhandle.dev/docs/platforms/tiktok.md (generated from the API, the source of truth for fields and types).

## Limitations

- Public content only.
- Regional and age restrictions can make otherwise public records unavailable.

## FAQ

### Can I use TikTok data commercially without the Research API?

Yes. Openhandle returns publicly visible TikTok data through its own API key, with no academic-access requirement.

### Does the API return real zeros?

Yes. A measured zero stays zero; an unavailable metric is returned as null.

### Can I use a username instead of an ID?

Yes. Put @username or the platform ID in any profile path, including /posts. Both forms return the same data.

### Are cursors shared with the upstream provider?

No. Treat Openhandle cursors as opaque and pass them back unchanged.

Docs: https://openhandle.dev/docs/platforms/tiktok · Pricing: https://openhandle.dev/pricing.md