# TikTok data API for AI agents: from $0.001 per call ($1 per 1,000), no subscription

> Whizbrew's TikTok data API costs from $0.001 per call ($1 per 1,000 calls); a typical call is $0.003 ($3 per 1,000). Only a call that returns data is charged: an empty or failed call is free. There is no subscription and no monthly fee. A new account starts with $2 of free credit, with no card.

It reads TikTok profiles, a creator's recent videos, comments, hashtags, sounds, search, TikTok Shop and the TikTok ad library: 45 tools, live at the moment of the call, over one API key or one MCP server (`https://whizbrew.com/mcp`). It is an API, not a scraper you run: no proxies, no browser and no scraping code on your side. The same key reaches 893 tools for other platforms ([all APIs](https://whizbrew.com/api), [all tools](https://whizbrew.com/tools?a=49130c17ebaa), [pricing](https://whizbrew.com/pricing?a=49130c17ebaa)).

## Pricing

| Tool | What it returns | Per call that returns data | Per 1,000 calls |
|---|---|---|---|
| `tiktok.profile` | Public TikTok profile of a creator or a brand: its stats (followers, following, likes, number of videos), bio, link and verified mark. | $0.002 | $2 |
| `tiktok.posts` | A TikTok account's recent videos (its posts), newest first: the latest videos of a creator, each with its views, likes, comments, shares and saves, its sound, hashtags and language, and pinned: true on a pinned post. TikTok rounds large counts for a visitor (2.1M): such a post carries approximate: true, and tiktok.video gives the exact counts of one post. Set "before" to read older posts. | $0.003 | $3 |
| `tiktok.comments` | Top-level comments on a public TikTok video (text, author, likes, reply count). Set "cursor" to read page by page: the answer is then {items, next_cursor, has_more}. | $0.003 | $3 |
| `tiktok.video` | One public TikTok video or photo post: text, counts, sound, hashtags, the country it was posted from (region), its language, the author's verified mark, TikTok's topic labels, whether it is marked as an ad, photo images and caption tracks. Set "transcript" to also get the spoken text when TikTok has captions. Media links are TikTok's own and expire. | $0.003 | $3 |
| `tiktok.comment_replies` | Replies to one comment on a public TikTok video (text, author, likes). Set "cursor" to read page by page: the answer is then {items, next_cursor, has_more}. | $0.003 | $3 |
| `tiktok.reposts` | Videos a TikTok account reposted to its followers, newest repost first. Each item is the original video with its own author. Set "cursor" to read page by page: the answer is then {items, next_cursor, has_more}. | $0.003 | $3 |
| `tiktok.search_suggestions` | The search terms TikTok suggests for a keyword (its autocomplete). | $0.001 | $1 |
| `tiktok.live` | Whether a TikTok account is live right now and, if it is, the room: title, viewers, start time. Or set "room_id" to check up to 50 live rooms in one call: the answer is then a list of {room_id, live}. | $0.002 | $2 |
| `tiktok.trending_hashtags` | The hashtags trending on TikTok in a country over the last 7, 30 or 90 days, from TikTok's own Creative Center: videos posted, views, a daily popularity curve and the top creators. TikTok shows a visitor the top 3. | $0.002 | $2 |
| `tiktok.top_videos` | The best performing TikTok videos made in the last 7 or 30 days in a country (US, JP, VN, TH, ID), from TikTok's own Creative Center, with exact views, organic views, engagement rate and 6-second view rate. TikTok shows a visitor the top 4. | $0.003 | $3 |
| `tiktok.trending_feed` | Videos TikTok is showing new visitors right now (its logged-out For You feed). A small sample that changes with every call; the country cannot be chosen. | $0.004 | $4 |
| `tiktok.profile_region` | The country TikTok files an account's newest videos under, and where they were posted from. Usually the creator's home market; an account that posts from several countries can read differently. | $0.003 | $3 |
| `tiktok.live_room` | The live room of an account that is live now: viewers now and in total, likes, category, game and the room's top 3 gifters. For an account that is not live it says so. Set "room_id" to read a room by its id instead; an ended room still gives its host, title and total viewers. | $0.003 | $3 |
| `tiktok.gifts` | The gifts viewers can send in TikTok live rooms: id, name, price in coins and image. Set "ids" to look up some gifts by id. | $0.002 | $2 |
| `tiktok.playlists` | The playlists a TikTok account shows on its profile: id, name and number of videos. An account without playlists gives an empty list. Set "cursor" to read page by page: the answer is then {items, next_cursor, has_more}. | $0.002 | $2 |
| `tiktok.playlist_videos` | The videos of one TikTok playlist, in the playlist's order. Set "cursor" to read page by page: the answer is then {items, next_cursor, has_more}. | $0.003 | $3 |
| `tiktok.stories` | The stories a TikTok account has up right now (they last 24 hours), with counts and the time each one expires. Most accounts have none: the list is then empty. | $0.003 | $3 |
| `tiktok.videos` | Up to 10 public TikTok videos or photo posts in one call, each as tiktok.video returns it, in the order asked. A post that cannot be read comes back as {id, error}; the call is charged when at least one post was read. | $0.01 | $10 |
| `tiktok.hashtag` | A TikTok hashtag: its description and exact totals of videos and views. | $0.002 | $2 |
| `tiktok.hashtag_videos` | Videos under a TikTok hashtag, as TikTok ranks them; also the closest thing to a TikTok keyword search (TikTok shows keyword results to logged-in accounts only): give the keyword as one word, e.g. skincare. "sort" (likes, views, newest) and "days" (posted in the last N days) are applied to all of the about 120 videos TikTok lists for a visitor, e.g. {"hashtag":"skincare","days":30,"sort":"likes"}. There is no country filter. Each video also carries its saves, the author's follower count, language, sound and hashtags. Counts marked approximate are rounded by TikTok: the first rows are read again from their own page for exact counts and for the country the video was posted from (region) ("exact_top", up to 10; 5 by default with sort likes or views), tiktok.videos does the same for any 10. Set "cursor" to read page by page: the answer is then {items, next_cursor, has_more}, and a page can hold some videos more than "limit". TikTok ends a visitor's list after about 140 videos and repeats a few between pages. | $0.003 | $3 |
| `tiktok.sound` | A TikTok sound: title, artist, length and how many videos use it. | $0.002 | $2 |
| `tiktok.sound_search` | Search TikTok sounds by keyword, with how many videos use each. Set "cursor" to read page by page: the answer is then {items, next_cursor, has_more}, and a page can hold a few sounds more than "limit". | $0.003 | $3 |
| `tiktok.sound_videos` | Videos that use a TikTok sound, with exact counts. Set "cursor" to read page by page: the answer is then {items, next_cursor, has_more}. A page can hold a few videos more than "limit". | $0.003 | $3 |
| `tiktok.live_search` | Search TikTok rooms that are live right now by keyword (title, host, viewers). Set "cursor" to read page by page: the answer is then {items, next_cursor, has_more}. TikTok shows a visitor about 35 rooms for a keyword. | $0.003 | $3 |
| `tiktok.trending_searches` | The search terms TikTok shows as trending right now (about 10, for the server's country). | $0.002 | $2 |
| `tiktok_ads.top` | Top performing TikTok ads in a country. Returns the first page only (up to 20 ads). | $0.006 | $6 |
| `tiktok_ads.top_detail` | One top TikTok ad: brand, landing page, countries, engagement and video files. | $0.006 | $6 |
| `tiktok_ads.top_analytics` | Performance of one top TikTok ad: click-through by second, keyframes, CTR percentile and engagement. | $0.006 | $6 |
| `tiktok_ads.filters` | Industries, objectives, countries, languages and periods that tiktok_ads.top accepts. | $0.003 | $3 |
| `tiktok_ads.sponsored_posts` | TikTok posts that creators marked as commercial (a brand partnership or promotion), newest first, for one creator or a whole country. EU/EEA countries and Brazil only. | $0.003 | $3 |
| `tiktok_ads.trending_video` | One trending TikTok video from tiktok_ads.trending_videos, with its metrics and top comments. | $0.003 | $3 |
| `tiktok_shop.product` | One TikTok Shop product: price, units sold, rating, variants with stock, seller, shipping, and the first page of reviews with the rating histogram. | $0.003 | $3 |
| `tiktok_shop.search` | Search TikTok Shop products by keyword (first page of results). "partial": true means TikTok returned a reduced result set; "source" names the page the products came from. | $0.003 | $3 |
| `tiktok_shop.store` | Public numbers of one TikTok Shop store: rating, units sold, product count, followers. | $0.002 | $2 |
| `tiktok_shop.store_products` | Products of one TikTok Shop store, best sellers first, 20 a page. Pass next_cursor as "cursor" for the next page. | $0.003 | $3 |
| `tiktok_shop.search_suggestions` | TikTok Shop search autocomplete terms for a keyword. Without a keyword: the searches TikTok Shop shows as trending. | $0.002 | $2 |
| `tiktok_shop.categories` | The TikTok Shop category tree: ids, names and slugs, each top category with its children. | $0.002 | $2 |
| `tiktok_shop.category_products` | Products TikTok Shop lists in one category: up to 60, the ones its category page shows a visitor (no next page). | $0.003 | $3 |
| `tiktok_shop.hot_products` | Products TikTok Shop recommends on its storefront home page right now. | $0.003 | $3 |
| `tiktok_shop.product_videos` | TikTok videos that sell one TikTok Shop product: creator handle, plays, likes, upload time, plus the searches TikTok relates to the product. | $0.003 | $3 |
| `tiktok_shop.top_products` | TikTok Shop's own best-seller ranking right now: about 20 products in rank order with price, units sold and rating. | $0.003 | $3 |
| `tiktok.search` | TikTok videos for a keyword, with exact counts: TikTok's own keyword search, the first 20 results, each with its text, hashtags, date, author (with followers and verified mark), exact plays, likes, comments, shares and saves, sound, length, language and the country it was posted from (region). sort: relevance (TikTok's order), likes (TikTok's most-liked order) or newest (the results of the time range, the last week when none is named, in date order). time_range keeps to posts of the last day, week, month or year. The data comes from a licensed social index (source says so, with as_of). The search is not limited to one country: region marks each row, and country keeps only the rows posted from one country (of the 20 found, so fewer come back). For a keyword TikTok knows nothing for it returns loosely related videos instead of none. When the licensed index is not available the tool answers from public search-engine indexes instead (source: search_index): a few dozen videos at most in the engines' order, not fresh, sort likes is not possible there, and found_by, index_* and engines_* describe that route. A keyword with no video is free. | $0.004 | $4 |
| `tiktok.search_users` | TikTok accounts for a keyword, from TikTok's own account search: handle, name, followers, following, number of videos, total likes, bio and verified mark, 20 a page in TikTok's order. Filter by follower range or to verified accounts; next_cursor reads the next page. From a licensed social index (source, as_of). A keyword with no account is free. | $0.003 | $3 |
| `tiktok.followers` | The accounts that follow a TikTok account, newest follower first, 20 a page: handle, name, followers, following, number of videos, total likes, bio, verified mark and country code. total is the account's follower count; next_cursor reads the next page. TikTok gives the list only for accounts that show it; an account that hides it answers an empty list with a note, free. From a licensed social index (source, as_of). | $0.005 | $5 |
| `tiktok.following` | The accounts a TikTok account follows, 20 a page: handle, name, followers, following, number of videos, total likes, bio, verified mark and country code. total is how many accounts it follows; next_cursor reads the next page. Many accounts hide this list: such a call answers an empty list with a note, free. From a licensed social index (source, as_of). | $0.005 | $5 |

## Example calls

`tiktok.profile` ($0.002 per call): Public TikTok profile of a creator or a brand: its stats (followers, following, likes, number of videos), bio,

```
curl -s -X POST https://whizbrew.com/v1/call/tiktok.profile \
  -H "Authorization: Bearer $WHIZBREW_KEY" -H "content-type: application/json" \
  -d '{"handle":"duolingo"}'
```

`tiktok.posts` ($0.003 per call): A TikTok account's recent videos (its posts), newest first: the latest videos of a creator, each with its view

```
curl -s -X POST https://whizbrew.com/v1/call/tiktok.posts \
  -H "Authorization: Bearer $WHIZBREW_KEY" -H "content-type: application/json" \
  -d '{"handle":"duolingo","limit":3}'
```

`tiktok.comments` ($0.003 per call): Top-level comments on a public TikTok video (text, author, likes, reply count)

```
curl -s -X POST https://whizbrew.com/v1/call/tiktok.comments \
  -H "Authorization: Bearer $WHIZBREW_KEY" -H "content-type: application/json" \
  -d '{"limit":3,"url":"https://www.tiktok.com/@duolingo/video/7106594312292453675"}'
```

Over MCP the same call is `call_tool` with `{"tool": "<name>", "arguments": {…}}`. How often each tool works, measured from real calls: [https://whizbrew.com/status](https://whizbrew.com/status).

## Start

- **An agent on its own**: read [https://whizbrew.com/agents.md?a=49130c17ebaa](https://whizbrew.com/agents.md?src=body-text&a=49130c17ebaa). It asks for a free quote (`GET https://whizbrew.com/v1/agent/guide?goal=<the task in plain words>`), then one request (`POST https://whizbrew.com/v1/agent/start?a=49130c17ebaa`) gives it a key that works at once with the free credit, with no email and no sign-up form. Its human claims the account later.
- **A chat app** (ChatGPT, Claude, Gemini): add the MCP server `https://whizbrew.com/mcp` as a custom connector and sign in. No key to copy.
- **An agent with a shell** (Claude Code, Codex, Cursor): read [https://whizbrew.com/llms.txt?a=49130c17ebaa](https://whizbrew.com/llms.txt?src=body-text&a=49130c17ebaa). The agent starts a pairing with one request, its user approves with one click, and the agent holds its own key.
- **Plain HTTP**: create an account at [https://whizbrew.com/app#signup](https://whizbrew.com/app#signup), make a key, then `POST https://whizbrew.com/v1/call/<tool>` with `Authorization: Bearer <key>`.
