# Tikultra

> TikTok’s native mobile API behind one REST API: 180+ endpoints with their upstream paths, request signing in under a millisecond, device contexts and connected sessions for accounts you own. Priced per call; failed calls are free.

Base URL: https://api.tikultra.com. Authenticate with the `x-api-key` header. Every response carries `x-credits-cost`, `x-credits-tier` and `x-credits-remaining`. Failed calls are not charged.

Pricing: Primitive 2 credits, Standard 5 credits, Heavy 10 credits, Premium 25 credits. Plans: Free $0/month for 2,500 credits, 3 req/s; Starter $29/month for 250,000 credits, 25 req/s ($0.58 per 1,000 standard calls); Growth $99/month for 1,250,000 credits, 75 req/s ($0.40 per 1,000 standard calls); Scale $349/month for 6,000,000 credits, 250 req/s ($0.29 per 1,000 standard calls); Enterprise from $1,499/month.

Pagination: every list endpoint takes `cursor` and `count` and returns `cursor` (string or null) and `has_more` (boolean) at the top level.

Clients: choose the app with `os` (android, ios), `app_flavour` (tiktok, lite, lite_coin, pro, studio, shop, tv, douyin) and optional `app_version` (40+ releases). Signing takes <1 ms. Device contexts can be pinned to 84 cities.

Resolve any TikTok link or @handle to typed IDs with `GET /v1/resolve?input=…` (2 credits). Older paths such as /v1/scrape/* and /v1/tools/* still work as aliases.

OpenAPI: https://tikultra.com/openapi.json

## Get started

- [Introduction](https://tikultra.com/docs/introduction): Tikultra is a gateway to TikTok’s native mobile API: managed endpoints that return JSON, devices and signing primitives for your own pipeline, and connected sessions for accounts you own.
- [Quickstart](https://tikultra.com/docs/quickstart): Create a key, fetch one TikTok video as JSON and see what the call cost. It takes about a minute.
- [Authentication](https://tikultra.com/docs/authentication): Every request needs an API key in the x-api-key header. Each key has its own credit balance; your plan sets its rate limit.
- [Credits and pricing](https://tikultra.com/docs/credits): Every endpoint has a fixed cost. Plans set your monthly credits; top-ups cost your plan’s rate.
- [Rate limits](https://tikultra.com/docs/rate-limits): Your plan sets requests per second for the whole account. Over the limit you get 429 with a retry-after header, at no cost.
- [Errors and retries](https://tikultra.com/docs/errors): Every error has a stable code and costs nothing. Retry 429s and 5xx with backoff; fix the rest.

## Run modes

- [Managed gateway](https://tikultra.com/docs/managed-gateway): One REST call returns typed JSON for videos, profiles, feeds, search, Tako AI, LIVE rooms, series and Shop product pages. We handle signing, contexts, retries and decoding.
- [Devices, signing & primitives](https://tikultra.com/docs/primitives): Bring your own HTTP pipeline. Sign native requests, provision device contexts, resolve links and decode protobuf payloads.
- [Connected sessions](https://tikultra.com/docs/connected-sessions): Bind sessions you own to dedicated 1:1 mobile contexts (FullPool) to publish, manage comments and DMs, and host LIVE. Growth and Scale.
- [Batch jobs](https://tikultra.com/docs/batch-jobs): Submit up to 500 tasks per job and get a webhook when it finishes. Growth and Scale.

## Working with data

- [Clients and versions](https://tikultra.com/docs/clients): Pick the app you run as with three fields: os, app_flavour and app_version. 8 app flavours, 40+ releases.
- [Pagination](https://tikultra.com/docs/pagination): Every list endpoint uses one contract: pass cursor and count, get back cursor and has_more at the top level.
- [IDs and the resolver](https://tikultra.com/docs/ids): TikTok IDs are 64-bit Snowflakes; the top 32 bits are the creation time. The resolver turns any link into typed IDs.
- [Media streams](https://tikultra.com/docs/media-streams): Video responses include the play stream’s codec, size and frame rate. Source files come from the no-watermark endpoint.
- [Contexts and egress](https://tikultra.com/docs/contexts): Calls run in isolated, pre-warmed device contexts with city-level egress in 84 cities, so sessions stay consistent and results stay local.
- [Webhooks](https://tikultra.com/docs/webhooks): Get told when credits run low, when an endpoint starts failing for you, or when a batch job finishes.

## Build with

- [AI agents and MCP](https://tikultra.com/docs/mcp): Give Claude, Cursor or any MCP client the gateway and its primitives as tools. Each tool says what it costs before it runs.
- [OpenAPI and llms.txt](https://tikultra.com/docs/openapi): Machine-readable descriptions of every endpoint, for code generation and agents.

## API reference

### Videos & comments

- [GET /v1/video](https://tikultra.com/docs/api/get-video): Get video. Video metadata, stats, author, sound and stream specs. Upstream: /aweme/v1/aweme/detail/. Cost: 5 cr.
- [POST /v1/video/batch](https://tikultra.com/docs/api/video-batch): Batch videos. Up to 50 videos in one call, billed per video. Upstream: /aweme/v1/multi/aweme/detail/. Cost: 5 cr / item.
- [GET /v1/video/comments](https://tikultra.com/docs/api/comments): Comments. A page of comments on a video. Upstream: /aweme/v2/comment/list/. Cost: 5 cr. (paginated)
- [GET /v1/video/comments/replies](https://tikultra.com/docs/api/comment-replies): Comment replies. A page of replies to one comment. Upstream: /aweme/v1/comment/list/reply/. Cost: 5 cr. (paginated)
- [GET /v1/video/comments/by-ids](https://tikultra.com/docs/api/comments-by-ids): Comments by ID. Look up comments by their IDs. Upstream: /tiktok/comment/status/batch_get/v1. Cost: 5 cr.
- [GET /v1/video/danmaku](https://tikultra.com/docs/api/danmaku): Danmaku. Time-coded floating reactions on a video. Upstream: /tiktok/danmaku/get/v1, /tiktok/danmaku/list/v1. Cost: 5 cr. (exclusive)
- [GET /v1/video/transcript](https://tikultra.com/docs/api/transcript): Transcript. Time-aligned caption tracks for a video. Upstream: /aweme/v1/aweme/detail/. Cost: 2 cr.
- [GET /v1/video/no-watermark](https://tikultra.com/docs/api/no-watermark): No-watermark media. Source 1080p60 ByteVC1 or H.264 master URLs. Upstream: /aweme/v1/aweme/detail/. Cost: 2 cr.
- [GET /v1/video/slideshow](https://tikultra.com/docs/api/slideshow-downloader): Slideshow media. Every source image and the audio of a carousel. Upstream: /aweme/v1/aweme/detail/. Cost: 2 cr.
- [GET /v1/video/duets](https://tikultra.com/docs/api/duets): Duets and stitches. Duets and stitches made from a video. Upstream: /tiktok/v1/duet/detail/. Cost: 5 cr. (paginated)
- [GET /v1/video/anchors](https://tikultra.com/docs/api/video-anchors): Video anchors. Shop, CapCut, place or effect anchors on a video. Upstream: /aweme/v1/anchor/aweme/. Cost: 5 cr.
- [GET /v1/video/upvotes](https://tikultra.com/docs/api/upvotes): Repost annotations. Public repost annotations on a post. Upstream: /tiktok/v1/upvote/batch_list/. Cost: 5 cr. (paginated)
- [GET /v1/video/share-info](https://tikultra.com/docs/api/share-info): Share info. The short share link and share metadata of a video. Upstream: /tiktok/share/link/shorten/v1/. Cost: 5 cr.
- [GET /v1/video/gifts](https://tikultra.com/docs/api/video-gifts): Video gifts. Gifts sent on a video. Upstream: /tiktok/v1/gift/list/. Cost: 5 cr.
- [GET /v1/video/forensics](https://tikultra.com/docs/api/video-forensics): Video forensics. Encoding, upload client and AI-generated content metadata. Upstream: /aweme/v1/aweme/detail/, /tiktok/inspect/item/v1. Cost: 10 cr.
- [GET /v1/video/fyp-velocity](https://tikultra.com/docs/api/fyp-velocity): FYP velocity. Play, like and share velocity of a post. Upstream: /aweme/v1/aweme/detail/. Cost: 10 cr.
- [GET /v1/video/comment-leads](https://tikultra.com/docs/api/comment-leads): Comment leads. Questions and purchase-intent comments, structured. Upstream: /aweme/v2/comment/list/. Cost: 10 cr.

### Users & profiles

- [GET /v1/user](https://tikultra.com/docs/api/get-profile): Get profile. Profile details, counts, bio and links. Upstream: /aweme/v1/user/profile/other/, /tiktok/user/profile/other/v1. Cost: 5 cr.
- [GET /v1/user/posts](https://tikultra.com/docs/api/profile-posts): Profile posts. A page of a profile's posts. Upstream: /aweme/v1/aweme/post/. Cost: 5 cr. (paginated)
- [GET /v1/user/with-posts](https://tikultra.com/docs/api/profile-with-posts): Profile with posts. A profile and its first page of posts in one call. Upstream: /aweme/v1/user/profile/other/, /aweme/v1/aweme/post/. Cost: 10 cr.
- [GET /v1/user/stories](https://tikultra.com/docs/api/stories): Stories. A user's active 24-hour stories. Upstream: /tiktok/story/archive/detail/v1, /tiktok/story/archive/list/v1. Cost: 5 cr. (exclusive, paginated)
- [POST /v1/user/stories/batch](https://tikultra.com/docs/api/stories-batch): Batch stories. Active stories for up to 20 users at once. Upstream: /tiktok/story/archive/detail/v1. Cost: 10 cr.
- [GET /v1/user/reposts](https://tikultra.com/docs/api/reposts): Reposts. The public repost feed of a profile. Upstream: /tiktok/v1/upvote/item/list/. Cost: 5 cr. (exclusive, paginated)
- [GET /v1/user/favorites](https://tikultra.com/docs/api/favorites): Favorites. Videos a profile has publicly favorited. Upstream: /aweme/v1/aweme/favorite/. Cost: 5 cr. (paginated)
- [GET /v1/user/playlists](https://tikultra.com/docs/api/playlists): Playlists. A creator's playlists. Upstream: /tiktok/v1/mix/list/. Cost: 5 cr. (paginated)
- [GET /v1/user/followers](https://tikultra.com/docs/api/followers): Followers. A page of followers. Upstream: /aweme/v1/user/follower/list/. Cost: 10 cr. (paginated)
- [GET /v1/user/followings](https://tikultra.com/docs/api/followings): Followings. A page of accounts a profile follows. Upstream: /aweme/v1/user/following/list/. Cost: 10 cr. (paginated)
- [GET /v1/user/followers/search](https://tikultra.com/docs/api/followers-search): Search followers. Search within a profile's followers. Upstream: /aweme/v1/user/follower/list/. Cost: 10 cr.
- [GET /v1/user/followings/search](https://tikultra.com/docs/api/followings-search): Search followings. Search within the accounts a profile follows. Upstream: /aweme/v1/user/following/list/. Cost: 10 cr.
- [GET /v1/user/similar](https://tikultra.com/docs/api/similar-users): Similar creators. Creators similar to a profile. Upstream: /aweme/v1/following/page/user/recommend/. Cost: 10 cr.
- [GET /v1/user/collections](https://tikultra.com/docs/api/collections): Collections. A profile's public collections. Upstream: /tiktok/collection/item_archive/list/v1. Cost: 5 cr. (paginated)
- [GET /v1/user/collections/videos](https://tikultra.com/docs/api/collection-videos): Collection videos. The videos in one collection. Upstream: /tiktok/collection/item_archive/item/list/v1. Cost: 5 cr. (paginated)
- [GET /v1/user/locate-post](https://tikultra.com/docs/api/locate-post): Locate post. Find where a post sits in a profile's timeline. Upstream: /aweme/v1/post/locate/. Cost: 10 cr.
- [GET /v1/user/series](https://tikultra.com/docs/api/user-series): Creator series. A creator's paid series. Upstream: /tiktok/v1/paid_content/collection/list/. Cost: 10 cr.
- [GET /v1/user/audit](https://tikultra.com/docs/api/account-audit): Creator audit. Engagement, cadence and reach diagnostics for a creator. Upstream: /aweme/v1/user/profile/other/, /aweme/v1/aweme/post/. Cost: 25 cr.
- [GET /v1/user/visibility](https://tikultra.com/docs/api/visibility): Visibility check. Search indexability and feed distribution diagnostics. Upstream: /aweme/v1/general/search/single/, /aweme/v1/aweme/post/. Cost: 25 cr.
- [GET /v1/user/compare](https://tikultra.com/docs/api/compare-users): Compare creators. Benchmark several creators side by side. Upstream: /aweme/v1/user/profile/other/. Cost: 25 cr.
- [GET /v1/user/check-username](https://tikultra.com/docs/api/check-username): Check username. Whether a username is available, taken or reserved. Upstream: /aweme/v1/unique/id/check/. Cost: 2 cr.
- [POST /v1/user/bulk-check](https://tikultra.com/docs/api/bulk-check): Bulk profile check. Whether each of up to 100 usernames exists and is public. Upstream: /aweme/v1/user/profile/other/. Cost: 5 cr / item.

### Feeds, search & Tako AI

- [GET /v1/feed/persona-fyp](https://tikultra.com/docs/api/persona-fyp): Persona For You feed. For You snapshots from a city-pinned, topic-calibrated context. Upstream: /aweme/v1/feed/. Cost: 10 cr. (exclusive, paginated)
- [GET /v1/feed/persona-fyp/cities](https://tikultra.com/docs/api/persona-cities): Supported persona cities. All 84 supported city slugs grouped by country code. Upstream: gateway · regional city catalog. Cost: Free.
- [GET /v1/feed](https://tikultra.com/docs/api/for-you-feed): Feeds. For You, Following, STEM, Explore and Nearby feeds. Upstream: /aweme/v1/feed/, /aweme/v2/follow/feed/, /tiktok/feed/stem/v2, /tiktok/feed/explore/v1, /tiktok/feed/nearby/revamp. Cost: 5 cr. (paginated)
- [GET /v1/feed/stories](https://tikultra.com/docs/api/feed-stories): Stories feed. The stories tray at the top of the feed. Upstream: /aweme/v2/follow/feed/skylight. Cost: 5 cr.
- [GET /v1/feed/landscape](https://tikultra.com/docs/api/feed-landscape): Landscape feed. The horizontal, full-screen video feed. Upstream: /tiktok/feed/horizontal/v2. Cost: 5 cr. (paginated)
- [GET /v1/search](https://tikultra.com/docs/api/search): Search. Search videos, users, LIVE, hashtags, sounds and places. Upstream: /aweme/v1/general/search/single/, /aweme/v1/search/item/, /aweme/v1/discover/search/, /aweme/v1/live/search/, /aweme/v1/challenge/search/, /aweme/v1/music/search/, /aweme/v1/search/place/. Cost: 5 cr. (paginated)
- [GET /v1/search/suggestions](https://tikultra.com/docs/api/search-suggestions): Search suggestions. Suggestions for a partial keyword. Upstream: /aweme/v1/search/sug/. Cost: 5 cr.
- [POST /v1/vision/ecom-search](https://tikultra.com/docs/api/vision-search): Vision search. Reverse image search across Shop products and matching videos. Upstream: /aweme/v1/search/photo/bff/ecom/, /aweme/v1/search/vision/general/. Cost: 25 cr. (exclusive)
- [POST /v1/tako/ask](https://tikultra.com/docs/api/tako-ask): Tako ask. Answers from TikTok's Tako assistant, with cited videos. Upstream: /aweme/v1/tako/op/stream/. Cost: 25 cr. (exclusive)
- [POST /v1/tako/chat](https://tikultra.com/docs/api/tako-chat): Tako chat. A multi-turn conversation with Tako. Upstream: /aweme/v1/tako/op/stream/. Cost: 25 cr.
- [GET /v1/tako/sug](https://tikultra.com/docs/api/tako-sug): Tako suggestions. Prompts Tako suggests for a video or topic. Upstream: /aweme/v1/tako/sug/. Cost: 5 cr.
- [GET /v1/tako/conversation](https://tikultra.com/docs/api/tako-conversation): Tako conversation. Messages in one of a connected account's Tako conversations. Upstream: /aweme/v1/tako/conversation/message/list/. Cost: 10 cr. (Growth plan and up)
- [GET /v1/tako/inbox](https://tikultra.com/docs/api/tako-inbox): Tako inbox. A connected account's Tako inbox. Upstream: /aweme/v1/tako/inbox/message/list/. Cost: 10 cr. (Growth plan and up)
- [GET /v1/tako/memory](https://tikultra.com/docs/api/tako-memory): Tako memory. What Tako remembers for a connected account. Upstream: /aweme/v1/tako/memory/list/. Cost: 10 cr. (Growth plan and up)
- [GET /v1/creator/search-insights](https://tikultra.com/docs/api/search-insights): Search insights. Studio search topics with content gaps. Upstream: /tiktok/v1/creator/search_insights/topics/. Cost: 25 cr. (paginated)
- [GET /v1/creator/search-insights/detail](https://tikultra.com/docs/api/search-insights-detail): Search insight detail. One search topic: volume, gap and related queries. Upstream: /tiktok/v1/creator/search_insights/detail/. Cost: 25 cr.
- [GET /v1/creator/search-insights/trend](https://tikultra.com/docs/api/search-insights-trend): Search insight trend. Search volume over time for a topic. Upstream: /tiktok/v1/creator/search_insights/detail/. Cost: 25 cr.
- [GET /v1/creator/search-insights/videos](https://tikultra.com/docs/api/search-insights-videos): Search insight videos. Top videos for a search topic. Upstream: /tiktok/v1/creator/search_insights/detail/. Cost: 25 cr. (paginated)
- [GET /v1/douyin/hot](https://tikultra.com/docs/api/douyin-hot): Douyin hot list. The Douyin hot search list. Upstream: /aweme/v1/hot/search/list/. Cost: 10 cr.
- [GET /v1/douyin/search](https://tikultra.com/docs/api/douyin-search): Douyin hot search. The Douyin hot search board for a keyword. Upstream: /aweme/v1/hot/search/list/. Cost: 10 cr.
- [GET /v1/douyin/brand](https://tikultra.com/docs/api/douyin-brand): Douyin brand board. The Douyin brand board. Upstream: /aweme/v1/hot/search/list/. Cost: 10 cr.
- [GET /v1/douyin/music](https://tikultra.com/docs/api/douyin-music): Douyin music board. The Douyin music board. Upstream: /aweme/v1/hot/search/list/. Cost: 10 cr.

### TikTok Shop

- [GET /v1/shop/pdp](https://tikultra.com/docs/api/shop-pdp): Product page. The full mobile SDUI product page tree. Upstream: /api/v2/shop/sdui_pdp/get, /api/v1/shop/item/product_info/get. Cost: 25 cr. (exclusive)
- [GET /v1/shop/live-bag](https://tikultra.com/docs/api/live-bag): LIVE shopping bag. Products pinned in a LIVE room, with prices and promos. Upstream: /aweme/v2/oec/live/bag/assemble, /aweme/v2/oec/live/bag/tabs_and_products. Cost: 25 cr. (exclusive)
- [GET /v1/shop/search](https://tikultra.com/docs/api/shop-search): Shop search. Search Shop products by keyword. Upstream: /aweme/v1/search/single/bff/ecom/, /aweme/v1/search/pack_product/ecom/. Cost: 25 cr. (paginated)
- [GET /v1/shop/seller](https://tikultra.com/docs/api/seller-catalog): Seller catalog. A seller's storefront and catalog. Upstream: /api/shop/v1/homepage/get, /api/shop/v1/product/list. Cost: 25 cr. (paginated)
- [GET /v1/shop/seller/categories](https://tikultra.com/docs/api/seller-categories): Seller categories. Categories inside a seller's storefront. Upstream: /api/shop/v1/category/list. Cost: 25 cr.
- [GET /v1/shop/seller/reviews](https://tikultra.com/docs/api/seller-reviews): Seller reviews. Verified buyer reviews across a seller’s shop. Upstream: /api/v1/shop_review/list. Cost: 25 cr. (paginated)
- [GET /v1/shop/showcase](https://tikultra.com/docs/api/showcase): Creator showcase. Products in a creator's showcase. Upstream: /api/showcase/v1/product/list, /api/showcase/v1/creator_info/get. Cost: 25 cr. (paginated)
- [GET /v1/shop/reviews](https://tikultra.com/docs/api/shop-reviews): Product reviews. Buyer reviews of a product or shop. Upstream: /api/v1/review/list, /api/v1/shop_review/list. Cost: 25 cr. (paginated)
- [GET /v1/shop/anchors](https://tikultra.com/docs/api/shop-anchors): Shop anchors. Products anchored to a video. Upstream: /aweme/v1/anchor/aweme/. Cost: 25 cr.
- [GET /v1/shop/mall](https://tikultra.com/docs/api/shop-mall): Mall home. The Shop mall home page. Upstream: /api/v1/mall/homepage/bff/get. Cost: 25 cr.
- [GET /v1/shop/tab](https://tikultra.com/docs/api/shop-tab): Shop tab. The Shop tab recommendations. Upstream: /api/v1/mall/shop_tab/algorithm/reach/get. Cost: 25 cr.
- [GET /v1/shop/live-products](https://tikultra.com/docs/api/shop-live-products): LIVE product pop-up. The product pop-up shown in a LIVE room. Upstream: /aweme/v1/oec/live/product/pop. Cost: 25 cr.
- [GET /v1/shop/live-room](https://tikultra.com/docs/api/shop-live-room): LIVE shop info. Commerce info for a LIVE room. Upstream: /aweme/v1/oec/live/room/common_info. Cost: 25 cr.
- [GET /v1/shop/suggestions](https://tikultra.com/docs/api/shop-suggestions): Shop suggestions. Shop search suggestions. Upstream: /aweme/v1/search/sug/prefetch/ecom/. Cost: 25 cr.
- [GET /v1/shop/creator](https://tikultra.com/docs/api/shop-creator): Shop creator. A creator's commerce profile. Upstream: /api/shop/v1/creator/info/get. Cost: 25 cr.
- [GET /v1/shop/same-shop](https://tikultra.com/docs/api/same-shop): More from this shop. Other products from the same shop. Upstream: /api/v1/shop/recommend/same_shop/get. Cost: 25 cr.
- [GET /v1/shop/recommendations](https://tikultra.com/docs/api/shop-recommendations): Product recommendations. Products recommended on a product page. Upstream: /api/v1/shop/pdp/recommendations/get. Cost: 25 cr.
- [GET /v1/shop/promotions](https://tikultra.com/docs/api/shop-promotions): Promotions. Active promotions on a product. Upstream: /api/v1/shop/promotion_info/get. Cost: 25 cr.
- [GET /v1/shop/translation](https://tikultra.com/docs/api/shop-translation): Product translation. Whether a product listing can be translated. Upstream: /aweme/v1/oec/content/anchors/get_product_translation_ability. Cost: 25 cr.

### LIVE rooms

- [GET /v1/live/room](https://tikultra.com/docs/api/live-room): LIVE room. Room state, host, viewer counts and stream metadata. Upstream: /webcast/room/enter/, /webcast/room/info/. Cost: 10 cr.
- [GET /v1/live/check-alive](https://tikultra.com/docs/api/live-check-alive): Is LIVE. Whether rooms are live right now. Upstream: /webcast/room/check_alive/. Cost: 5 cr.
- [GET /v1/live/chat](https://tikultra.com/docs/api/live-chat): LIVE chat. Decoded chat, gift and room events. Upstream: /webcast/im/fetch/. Cost: 10 cr. (paginated)
- [GET /v1/live/with-chat](https://tikultra.com/docs/api/live-with-chat): LIVE room with chat. Room state and the latest chat events in one call. Upstream: /webcast/room/info/, /webcast/im/fetch/. Cost: 10 cr. (paginated)
- [GET /v1/live/stream](https://tikultra.com/docs/api/live-stream): LIVE stream URLs. FLV and HLS stream URLs at each quality. Upstream: /webcast/room/info/. Cost: 10 cr.
- [GET /v1/live/audience](https://tikultra.com/docs/api/live-audience): LIVE audience. The online audience ranking. Upstream: /webcast/ranklist/online_audience/. Cost: 10 cr.
- [GET /v1/live/ranking](https://tikultra.com/docs/api/live-ranking): LIVE hourly ranking. The hourly LIVE ranking. Upstream: /webcast/ranklist/hour/. Cost: 10 cr.
- [GET /v1/live/gifts](https://tikultra.com/docs/api/live-gifts): LIVE gift catalog. The gifts available in a room, with coin prices. Upstream: /webcast/gift/list/. Cost: 10 cr.
- [GET /v1/live/recommended](https://tikultra.com/docs/api/live-recommended): Recommended LIVE. Rooms the LIVE feed recommends. Upstream: /webcast/feed/. Cost: 10 cr.
- [GET /v1/live/goody-bag](https://tikultra.com/docs/api/goody-bag): Goody bag. Details of a room’s goody bag. Upstream: /webcast/goody_bag/detail/. Cost: 10 cr.
- [GET /v1/live/bag-items](https://tikultra.com/docs/api/live-bag-items): LIVE bag items. Every product in a room’s shopping bag. Upstream: /aweme/v2/oec/live/bag/assemble. Cost: 10 cr.

### Series, sounds, hashtags & places

- [GET /v1/series/mini-dramas](https://tikultra.com/docs/api/mini-dramas): Mini dramas. The short-drama catalog with episode metrics. Upstream: /tiktok/v1/paid_content/mini_drama/feed/, /tiktok/v1/paid_content/mini_drama/tabs/. Cost: 10 cr. (exclusive, paginated)
- [GET /v1/series/mini-dramas/tabs](https://tikultra.com/docs/api/mini-drama-tabs): Mini drama tabs. The tabs of the short-drama catalog. Upstream: /tiktok/v1/paid_content/mini_drama/tabs/. Cost: 10 cr.
- [GET /v1/series/mini-dramas/history](https://tikultra.com/docs/api/mini-drama-history): Mini drama watch history. Short-drama watch history for a connected account. Upstream: /tiktok/v1/paid_content/mini_drama/watch_history/. Cost: 10 cr. (paginated, Growth plan and up)
- [GET /v1/series](https://tikultra.com/docs/api/series): Series. One series: title, price and episodes. Upstream: /tiktok/v1/paid_content/collection/detail/. Cost: 10 cr.
- [GET /v1/series/videos](https://tikultra.com/docs/api/series-videos): Series episodes. The episodes of a series. Upstream: /tiktok/v1/paid_content/collection/detail/. Cost: 10 cr. (paginated)
- [GET /v1/mix](https://tikultra.com/docs/api/mix): Playlist. One playlist (mix). Upstream: /tiktok/v1/mix/detail/. Cost: 10 cr.
- [GET /v1/mix/videos](https://tikultra.com/docs/api/mix-videos): Playlist videos. The videos in a playlist. Upstream: /tiktok/v1/mix/aweme/. Cost: 10 cr. (paginated)
- [GET /v1/music](https://tikultra.com/docs/api/music): Sound. A sound and the videos that use it. Upstream: /aweme/v1/music/detail/, /aweme/v1/music/aweme/. Cost: 5 cr. (paginated)
- [GET /v1/music/fresh](https://tikultra.com/docs/api/music-fresh): Sound: newest videos. The newest videos using a sound. Upstream: /aweme/v1/music/fresh/aweme/. Cost: 5 cr. (paginated)
- [GET /v1/music/user-original](https://tikultra.com/docs/api/music-user-original): Original sounds. Original sounds a creator made. Upstream: /aweme/v1/original/music/list/. Cost: 5 cr. (paginated)
- [GET /v1/music/charts](https://tikultra.com/docs/api/music-charts): Sound charts. The music charts. Upstream: /tiktok/chart/music/list/v1/. Cost: 10 cr.
- [GET /v1/hashtag](https://tikultra.com/docs/api/hashtag): Hashtag. A hashtag and its videos. Upstream: /aweme/v1/challenge/detail/, /aweme/v1/challenge/aweme/. Cost: 5 cr. (paginated)
- [GET /v1/hashtag/trending](https://tikultra.com/docs/api/hashtag-trending): Trending hashtags. Trending hashtag categories. Upstream: /aweme/v2/category/list/. Cost: 10 cr.
- [GET /v1/sticker](https://tikultra.com/docs/api/sticker): Effect. An effect and its stats. Upstream: /aweme/v1/sticker/detail/. Cost: 5 cr.
- [GET /v1/poi](https://tikultra.com/docs/api/poi): Place. A place, its reviews and videos tagged there. Upstream: /tiktok/poi/get/v1, /tiktok/poi/review/get/v2. Cost: 5 cr.
- [GET /v1/aistyle](https://tikultra.com/docs/api/aistyle): AI style. An AI style effect. Upstream: /tiktok/v1/aistyle/detail. Cost: 5 cr.
- [GET /v1/aistyle/videos](https://tikultra.com/docs/api/aistyle-videos): AI style videos. Videos made with an AI style. Upstream: /tiktok/v1/aistyle/aweme. Cost: 5 cr. (paginated)
- [GET /v1/capcut/template](https://tikultra.com/docs/api/capcut-template): CapCut template. A CapCut template. Upstream: /tiktok/v1/capcut/template/. Cost: 5 cr.
- [GET /v1/capcut/videos](https://tikultra.com/docs/api/capcut-videos): CapCut template videos. Videos made from a CapCut template. Upstream: /tiktok/v1/capcut/template/. Cost: 5 cr. (paginated)
- [GET /v1/mv-template](https://tikultra.com/docs/api/mv-template): MV template. A photo-to-video (MV) template. Upstream: /aweme/v1/mv/detail/. Cost: 5 cr.
- [GET /v1/translate](https://tikultra.com/docs/api/translate): Translate. TikTok's own translation of a caption or comment. Upstream: /aweme/v1/content/translation/. Cost: 5 cr.

### Connected sessions

- [POST /v1/account/import](https://tikultra.com/docs/api/import-session): Import session. Bind a session you own to a dedicated mobile context. Upstream: /passport/account/info/v2/, /aweme/v1/user/profile/self/. Cost: 25 cr. (Growth plan and up)
- [POST /v1/account/login/otp/send](https://tikultra.com/docs/api/otp-send): Email sign-in: send code. Send a one-time sign-in code to your account’s email. Upstream: /passport/email/send_code/. Cost: 25 cr. (Growth plan and up)
- [POST /v1/account/login/otp/verify](https://tikultra.com/docs/api/otp-verify): Email sign-in: verify code. Finish signing in with the one-time code. Upstream: /passport/email/login/. Cost: 25 cr. (Growth plan and up)
- [POST /v1/account/session](https://tikultra.com/docs/api/session-state): Refresh session. Refresh a session and return its state. Upstream: /passport/account/info/v2/. Cost: 25 cr. (Growth plan and up)
- [GET /v1/account/health](https://tikultra.com/docs/api/account-health): Session health. Whether a session is healthy, needs a refresh or has expired. Upstream: /passport/account/info/v2/. Cost: 15 cr. (Growth plan and up)
- [POST /v1/account/warm/niche](https://tikultra.com/docs/api/warm-niche): Warm session for niche. Calibrate a connected session’s For You feed toward a topic. Upstream: /aweme/v1/feed/, /aweme/v1/general/search/single/. Cost: 25 cr. (Growth plan and up)
- [GET /v1/account/upload/precheck](https://tikultra.com/docs/api/upload-precheck): Upload precheck. Check direct-post eligibility and duration limits before uploading. Upstream: /tiktok/v1/infringement/precheck/. Cost: 15 cr. (Growth plan and up)
- [POST /v1/account/upload/video](https://tikultra.com/docs/api/upload-video): Publish video. Upload and publish a video in one call. Upstream: /aweme/v1/upload/authkey/, /tiktok/v1/infringement/precheck/, /aweme/v1/create/aweme/. Cost: 100 cr. (Growth plan and up)
- [POST /v1/account/upload/slideshow](https://tikultra.com/docs/api/upload-slideshow): Publish slideshow. Upload and publish a photo carousel in one call. Upstream: /aweme/v1/upload/authkey/, /aweme/v1/create/photo/. Cost: 100 cr. (Growth plan and up)
- [POST /v1/account/upload/delete](https://tikultra.com/docs/api/delete-post): Delete post. Delete one of your posts. Upstream: /aweme/v1/aweme/delete/. Cost: 15 cr. (Growth plan and up)
- [POST /v1/account/post/visibility](https://tikultra.com/docs/api/post-visibility): Post visibility. Change who can see one of your posts. Upstream: /aweme/v1/aweme/modify/visibility/. Cost: 15 cr. (Growth plan and up)
- [GET /v1/account/upload/places](https://tikultra.com/docs/api/upload-places): Places for a post. Search places to tag on a post. Upstream: /tiktok/poi/api/place/search. Cost: 15 cr. (Growth plan and up)
- [POST /v1/account/profile/update](https://tikultra.com/docs/api/profile-update): Update profile. Change your nickname, bio or links. Upstream: /aweme/v1/commit/user/. Cost: 25 cr. (Growth plan and up)
- [POST /v1/account/profile/username](https://tikultra.com/docs/api/profile-username): Change username. Change your @username. Upstream: /passport/login_name/update/. Cost: 25 cr. (Growth plan and up)
- [POST /v1/account/profile/avatar](https://tikultra.com/docs/api/profile-avatar): Change avatar. Upload a new profile picture. Upstream: /aweme/v1/upload/image/. Cost: 25 cr. (Growth plan and up)
- [POST /v1/account/profile/privacy](https://tikultra.com/docs/api/profile-privacy): Privacy settings. Private account, who can comment, duet, stitch or message. Upstream: /tiktok/privacy/user/settings/update/v1. Cost: 25 cr. (Growth plan and up)
- [POST /v1/account/settings](https://tikultra.com/docs/api/account-settings): App settings. Change account settings. Upstream: /aweme/v1/user/set/settings/. Cost: 15 cr. (Growth plan and up)
- [POST /v1/account/wellbeing](https://tikultra.com/docs/api/wellbeing): Digital wellbeing. Screen time and restricted mode settings. Upstream: /tiktok/v1/digital_wellbeing/settings/. Cost: 15 cr. (Growth plan and up)
- [POST /v1/account/comment](https://tikultra.com/docs/api/comment): Post comment. Comment, or reply to a comment on your posts. Upstream: /aweme/v1/comment/publish/. Cost: 25 cr. (Growth plan and up)
- [POST /v1/account/comment/like](https://tikultra.com/docs/api/comment-like): Like comment. Heart a comment on your post. Upstream: /aweme/v1/comment/digg/. Cost: 15 cr. (Growth plan and up)
- [POST /v1/account/comment/unlike](https://tikultra.com/docs/api/comment-unlike): Unlike comment. Remove a heart from a comment. Upstream: /aweme/v1/comment/digg/. Cost: 15 cr. (Growth plan and up)
- [POST /v1/account/comment/delete](https://tikultra.com/docs/api/comment-delete): Delete comment. Delete a comment on your post, or one you wrote. Upstream: /aweme/v1/comment/delete/. Cost: 15 cr. (Growth plan and up)
- [GET /v1/account/dm/inbox](https://tikultra.com/docs/api/inbox): Inbox. New messages across conversations. Upstream: /im/v1/messages/get_by_user. Cost: 20 cr. (paginated, Growth plan and up)
- [GET /v1/account/dm/conversation/list](https://tikultra.com/docs/api/dm-conversations): Conversations. Your conversations, newest first. Upstream: /im/v1/conversation/get_list. Cost: 20 cr. (paginated, Growth plan and up)
- [GET /v1/account/dm/conversation/messages](https://tikultra.com/docs/api/dm-messages): Conversation messages. Messages in one conversation. Upstream: /im/v1/messages/get_by_user. Cost: 20 cr. (paginated, Growth plan and up)
- [POST /v1/account/dm/conversation/create](https://tikultra.com/docs/api/dm-create): Start conversation. Open a conversation with someone. Upstream: /im/v1/conversation/create_v2. Cost: 20 cr. (Growth plan and up)
- [POST /v1/account/dm/conversation/read](https://tikultra.com/docs/api/dm-read): Mark read. Mark a conversation as read. Upstream: /im/v1/conversation/mark_read. Cost: 20 cr. (Growth plan and up)
- [POST /v1/account/dm/send](https://tikultra.com/docs/api/send-dm): Send message. Send a text message. Upstream: /im/v1/message/send. Cost: 35 cr. (Growth plan and up)
- [POST /v1/account/dm/send-image](https://tikultra.com/docs/api/dm-send-image): Send image. Send an image. Upstream: /im/v1/message/send. Cost: 35 cr. (Growth plan and up)
- [POST /v1/account/dm/send-voice](https://tikultra.com/docs/api/dm-send-voice): Send voice note. Send a voice note. Upstream: /im/v1/message/send. Cost: 35 cr. (Growth plan and up)
- [POST /v1/account/dm/reply](https://tikultra.com/docs/api/dm-reply): Reply to message. Reply to a specific message. Upstream: /im/v1/message/send. Cost: 35 cr. (Growth plan and up)
- [POST /v1/account/dm/sticker](https://tikultra.com/docs/api/dm-sticker): Send sticker. Send a sticker. Upstream: /im/v1/message/send. Cost: 35 cr. (Growth plan and up)
- [POST /v1/account/dm/share-video](https://tikultra.com/docs/api/dm-share-video): Share video. Share a video in a conversation. Upstream: /im/v1/message/send. Cost: 35 cr. (Growth plan and up)
- [POST /v1/account/dm/react](https://tikultra.com/docs/api/dm-react): React to message. Add an emoji reaction to a message. Upstream: /im/v1/message/send. Cost: 15 cr. (Growth plan and up)
- [POST /v1/account/dm/recall](https://tikultra.com/docs/api/dm-recall): Unsend message. Unsend a message you sent. Upstream: /im/v1/message/send. Cost: 15 cr. (Growth plan and up)
- [GET /v1/account/dm/group/info](https://tikultra.com/docs/api/dm-group-info): Group info. A group chat’s name and settings. Upstream: /im/v1/conversation/get_list. Cost: 20 cr. (Growth plan and up)
- [GET /v1/account/dm/group/members](https://tikultra.com/docs/api/dm-group-members): Group members. The members of a group chat. Upstream: /im/v1/conversation/get_list. Cost: 20 cr. (Growth plan and up)
- [GET /v1/account/dm/streaks](https://tikultra.com/docs/api/dm-streaks): Streaks. Message streaks with your contacts. Upstream: /tiktok/v1/im/streaks/info. Cost: 20 cr. (Growth plan and up)
- [POST /v1/account/live/start](https://tikultra.com/docs/api/live-start): Start LIVE. Create a LIVE room on your account and get the RTMP ingest. Upstream: /webcast/room/create/. Cost: 100 cr. (Growth plan and up)
- [POST /v1/account/live/ping](https://tikultra.com/docs/api/live-ping): LIVE heartbeat. Keep your room open while you stream. Upstream: /webcast/room/ping/anchor/. Cost: 15 cr. (Growth plan and up)
- [POST /v1/account/live/finish](https://tikultra.com/docs/api/live-finish): End LIVE. End your LIVE. Upstream: /webcast/room/finish/. Cost: 15 cr. (Growth plan and up)
- [POST /v1/account/live/moderate](https://tikultra.com/docs/api/live-moderate): Moderate LIVE. Post, pin or remove comments and mute viewers in your room. Upstream: /webcast/room/chat/. Cost: 20 cr. (Growth plan and up)
- [POST /v1/account/live/cohost](https://tikultra.com/docs/api/live-cohost): Co-host. Invite or accept a co-host in your room. Upstream: /webcast/room/chat/. Cost: 20 cr. (Growth plan and up)
- [POST /v1/account/live/battle](https://tikultra.com/docs/api/live-battle): LIVE match. Start or accept a LIVE match from your room. Upstream: /webcast/room/chat/. Cost: 20 cr. (Growth plan and up)
- [GET /v1/account/shop/cart](https://tikultra.com/docs/api/shop-cart): Cart. Your account's Shop cart. Upstream: /api/v1/shop/cart/get_cart. Cost: 25 cr. (Growth plan and up)
- [GET /v1/account/shop/order-center](https://tikultra.com/docs/api/shop-order-center): Orders. Your account's Shop orders. Upstream: /api/v1/trade/entrance/get. Cost: 25 cr. (Growth plan and up)
- [GET /v1/account/shop/cs](https://tikultra.com/docs/api/shop-cs): Shop support chat. Your conversations with Shop sellers’ support. Upstream: /api/v1/cs/rt. Cost: 25 cr. (Growth plan and up)

### Devices, signing & primitives

- [GET /v1/resolve](https://tikultra.com/docs/api/resolve): Resolve. Any link or @handle to typed IDs. Upstream: redirect + /aweme/v1/aweme/detail/. Cost: 2 cr.
- [POST /v1/resolve](https://tikultra.com/docs/api/resolve-post): Resolve (POST). The same resolver, with a JSON body. Upstream: redirect + /aweme/v1/aweme/detail/. Cost: 2 cr.
- [GET /v1/tools/id-converter](https://tikultra.com/docs/api/id-converter): ID converter. Snowflake timestamps and uid ↔ sec_uid lookups. Upstream: local · snowflake + /aweme/v1/user/profile/other/. Cost: 2 cr.
- [POST /v1/tools/protobuf-decode](https://tikultra.com/docs/api/protobuf-decode): Protobuf decode. Decode a raw protobuf payload to JSON. Upstream: local · protobuf decoder. Cost: 2 cr.
- [POST /v1/jobs/submit](https://tikultra.com/docs/api/submit-batch-job): Submit batch job. Up to 500 tasks, run async, billed per task. Upstream: gateway · async batch queue (up to 500 tasks). Cost: per task.
- [GET /v1/jobs/{id}](https://tikultra.com/docs/api/get-job): Get job. A job’s progress and results. Upstream: gateway · async batch queue. Cost: Free.
- [GET /v1/devices](https://tikultra.com/docs/api/list-devices): List devices. Every device context your keys have provisioned. Upstream: gateway · context registry. Cost: Free.
- [POST /v1/devices/provision](https://tikultra.com/docs/api/provision-device): Provision device. A dedicated mobile device context pinned to a city. Upstream: /service/2/device_register/. Cost: 10 cr. (Growth plan and up)
- [GET /v1/devices/templates](https://tikultra.com/docs/api/device-templates): Hardware templates. The 237 Android and 15 iOS hardware profiles. Upstream: gateway · client & device catalog. Cost: Free.
- [GET /v1/apps/versions](https://tikultra.com/docs/api/app-versions): App versions. Every supported (os, app_flavour, app_version). Upstream: gateway · client & device catalog. Cost: Free.
- [GET /v1/devices/{id}](https://tikultra.com/docs/api/get-device): Get device. One device context and its state. Upstream: gateway · context registry. Cost: Free.
- [POST /v1/devices/{id}/bootstrap](https://tikultra.com/docs/api/bootstrap-device): Bootstrap device. Register a provisioned device so it is ready for calls. Upstream: /service/2/device_register/, /service/2/app_alert_check/. Cost: 10 cr. (Growth plan and up)
- [POST /v1/devices/{id}/report](https://tikultra.com/docs/api/device-report): Device security report. Execute scheduled security telemetry scenes on a provisioned device. Upstream: /sdi/get_seed, /ri/report. Cost: 10 cr. (Growth plan and up)
- [POST /v1/crypto/sign](https://tikultra.com/docs/api/sign-request): Sign request. Native signature headers for a request you will send. Upstream: local · native request signer (<1 ms). Cost: 2 cr.
- [POST /v1/crypto/x-cylons](https://tikultra.com/docs/api/x-cylons): X-Cylons token. Generate an X-Cylons session-binding header from query, stub, and Lanus keys. Upstream: local · X-Cylons SM3/MD5 signer. Cost: 2 cr.
- [POST /v1/crypto/x-argus/decrypt](https://tikultra.com/docs/api/x-argus-decrypt): X-Argus decrypt. Decrypt and inspect an external X-Argus header into typed fields. Upstream: local · X-Argus cipher & protobuf inspector. Cost: 2 cr.
- [POST /v1/crypto/x-ladon/decrypt](https://tikultra.com/docs/api/x-ladon-decrypt): X-Ladon decrypt. Decrypt an external X-Ladon header into timestamp, license ID and aid. Upstream: local · X-Ladon cipher inspector. Cost: 2 cr.
- [POST /v1/crypto/x-gorgon/decrypt](https://tikultra.com/docs/api/x-gorgon-decrypt): X-Gorgon decrypt. Decrypt an external X-Gorgon header into query digest, timestamp and SDK version. Upstream: local · X-Gorgon cipher inspector. Cost: 2 cr.
- [POST /v1/crypto/ttencrypt/encrypt](https://tikultra.com/docs/api/ttencrypt-encrypt): TTEncrypt encode. Encrypt telemetry or registration JSON with TTEncrypt. Upstream: local · TTEncrypt codec. Cost: 2 cr.
- [POST /v1/crypto/ttencrypt/decrypt](https://tikultra.com/docs/api/ttencrypt-decrypt): TTEncrypt decode. Decrypt an external TTEncrypt frame into UTF-8 and parsed JSON. Upstream: local · TTEncrypt codec. Cost: 2 cr.
- [POST /v1/crypto/zstd/compress](https://tikultra.com/docs/api/zstd-compress): zstd compress. Compress a payload with zstd. Upstream: local · zstd codec. Cost: 2 cr.
- [POST /v1/crypto/zstd/decompress](https://tikultra.com/docs/api/zstd-decompress): zstd decompress. Decompress a zstd payload. Upstream: local · zstd codec. Cost: 2 cr.
- [POST /v1/crypto/passport-hash](https://tikultra.com/docs/api/passport-hash): Passport identifier hash. Compute Passport XOR-5 hex, TTP identifier SHA-256 and session scramble values. Upstream: local · Passport XOR5 & TTP hash. Cost: 2 cr.

## Optional

- [Pricing](https://tikultra.com/pricing)
- [Status](https://tikultra.com/status)
- [Changelog](https://tikultra.com/changelog)
- [Acceptable use](https://tikultra.com/acceptable-use)