TikTok Hashtag Scraper, Video Stats and Engagement API

TikTok Hashtag Scraper, Video Stats and Engagement API: enter hashtags, get the videos TikTok lists under each with views, likes, comments, shares, saves, caption, music and creator handle. Schedule it to track a hashtag over time. Pay per video; failed rows are free.

What data does TikTok Hashtag Scraper, Video Stats and Engagement API return?

Each run returns one dataset item per result with these fields:

Field	Type	Description
id	string or null	TikTok's numeric video ID, as a string (it is too long for a JSON number). Null on a hashtag error row.
url	string	The video's canonical page, https://www.tiktok.com/@handle/video/ID. On a hashtag error row, the hashtag page that was tried.
inputUrl	string	The video link as the hashtag page listed it. On a hashtag error row, your hashtag entry exactly as given.
hashtag	string	The hashtag from your input that listed this video, in lower case without the # sign.
text	string	The video caption, hashtags included, as written by the creator.
createTime	string or null	When the video was posted (ISO 8601, UTC).
durationSec	number or null	Video length in seconds.
playCount	integer or null	Play count as TikTok shows it at the time of the run (TikTok rounds large numbers, for example 1200000).
likeCount	integer or null	Like (heart) count.
commentCount	integer or null	Comment count.
shareCount	integer or null	Share count.
collectCount	integer or null	How many times the video was saved to favorites.
hashtags	array of string	Hashtag names used in the caption, without the # sign, in caption order.
music	object or null	The sound used in the video: id, title, the name credited for the sound, and whether it is the creator's original sound.
coverUrl	string or null	Link to the video's cover image (a still frame). TikTok signs these links and they expire after a few days.
isAd	boolean or null	True when TikTok marks the video as an ad.
author	object	The account that posted the video: handle, display name, verified badge and follower count. No bio, avatar or contact details.
scrapedAt	string	When this row was collected (ISO 8601, UTC).
error	string or null	Null on a video row. On a free error row, why no video was delivered for this URL.

Sample output

Real output from the prefilled example input (first 3 of 10 results):

[
  {
    "id": "7695368862266625312",
    "url": "https://www.tiktok.com/@alenakhmil/video/7695368862266625312",
    "inputUrl": "https://www.tiktok.com/@alenakhmil/video/7695368862266625312",
    "hashtag": "cooking",
    "text": "Steak Pasta 🥩 Ingredients: Steak Pasta Butter Rosemary Garlic Heavy cream Chili pepper Black pepper Parmesan Pasta water Salt Sear the steak on both sides until golden brown. Add butter, rosemary and garlic, and baste the steak with the melted butter. Remove from the pan, season with salt and pepper, and let it rest. In the same pan, add a garlic clove and sauté briefly. Pour in the cream, add chili pepper, black pepper, Parmesan and a little pasta water. Stir well until the sauce becomes creamy. Add the cooked pasta and toss until evenly coated with the sauce. Slice the steak and serve over the creamy pasta. Pasta con Steak 🥩 Ingredientes: Filete de ternera Pasta Mantequilla Romero Ajo Nata para cocinar Chile Pimienta negra Parmesano Agua de cocción de la pasta Sal Dora el filete por ambos lados. Añade la mantequilla, el romero y el ajo, y baña la carne con la mantequilla derretida. Retira de la sartén, salpimenta y deja reposar. En la misma sartén, añade un diente de ajo y sofríelo brevemente. Vierte la nata, añade el chile, la pimienta negra, el parmesano y un poco de agua de cocción de la pasta. Mezcla bien hasta obtener una salsa cremosa. Incorpora la pasta cocida y mezcla hasta que quede bien cubierta con la salsa. Corta el filete en rodajas y sírvelo sobre la pasta cremosa. #steakpasta #creamypasta #steakrecipe #pastarecipe #homemadecooking ",
    "createTime": "2026-10-11T11:21:29.000Z",
    "durationSec": 22,
    "playCount": 3100000,
    "likeCount": 277100,
    "commentCount": 336,
    "shareCount": 13600,
    "collectCount": 32419,
    "hashtags": [
      "steakpasta",
      "creamypasta",
      "steakrecipe",
      "pastarecipe",
      "homemadecooking"
    ],
    "music": {
      "id": "7412402886251563782",
      "title": "som original",
      "authorName": "euamomusiica",
      "original": true
    },
    "coverUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/ogWLjuf8VEMAIAGvcFlLWDJIIDGAriAexgehTs~tplv-tiktokx-origin.image?dr=9636&x-expires=1793844000&x-signature=GuR6yHXwT1nOo1hO1h%2Ffql28iHU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
    "isAd": false,
    "author": {
      "handle": "alenakhmil",
      "nickname": "Alena",
      "verified": false,
      "followerCount": 825600
    },
    "scrapedAt": "2026-11-02T20:00:00.000Z",
    "error": null
  },
  {
    "id": "7697694616400809247",
    "url": "https://www.tiktok.com/@__kaylabee/video/7697694616400809247",
    "inputUrl": "https://www.tiktok.com/@__kaylabee/video/7697694616400809247",
    "hashtag": "cooking",
    "text": "Million Dollar Lasagna Rolls Recipe🔥 @Rao’s Homemade, I’m obsessed with your sauces. Let’s be besties🫶🏽#dinnerideas #lasagnarollups ",
    "createTime": "2026-10-17T17:46:51.000Z",
    "durationSec": 67,
    "playCount": 1100000,
    "likeCount": 100600,
    "commentCount": 391,
    "shareCount": 22700,
    "collectCount": 58508,
    "hashtags": [
      "dinnerideas",
      "lasagnarollups"
    ],
    "music": {
      "id": "7697694682066750239",
      "title": "original sound",
      "authorName": "__kaylabee",
      "original": true
    },
    "coverUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/osBqz6VrbDEiuLTOZyPtKIABtIaIvmiycRjPA~tplv-tiktokx-origin.image?dr=9636&x-expires=1793844000&x-signature=4JcfL%2FLmugg5h4CXD8WMA6M9e4U%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
    "isAd": true,
    "author": {
      "handle": "__kaylabee",
      "nickname": "__kaylabee",
      "verified": false,
      "followerCount": 1100000
    },
    "scrapedAt": "2026-11-02T20:00:00.000Z",
    "error": null
  },
  {
    "id": "7688777168045788448",
    "url": "https://www.tiktok.com/@_nada_dl/video/7688777168045788448",
    "inputUrl": "https://www.tiktok.com/@_nada_dl/video/7688777168045788448",
    "hashtag": "cooking",
    "text": "Hot honey crispy chicken burgers You can find the app via the link in my bio, or simply search « Osta Recipes » on the App Store or Google Play Store! @Osta - Recipe Tracker  Ingredients: Chicken Marinade: Chicken breast 300 ml buttermilk Salt, black pepper Garlic powder, onion powder, chicken seasoning, paprika 1 egg 1 tbsp white vinegar Hot sauce Dredge: 1 cup all-purpose flour 1 cup cornstarch Salt, black pepper, chicken seasoning, garlic powder, paprika Hot Honey Glaze: 1 tbsp butter 1 tbsp honey Hot sauce Salt, black pepper Garlic powder, onion powder Brown sugar, paprika Sauce: Mayonnaise Black pepper, garlic powder Chopped parsley A squeeze of lemon juice #burger #hothoneychicken #crispychicken #food #cooking",
    "createTime": "2026-09-23T17:02:20.000Z",
    "durationSec": 25,
    "playCount": 6400000,
    "likeCount": 691300,
    "commentCount": 594,
    "shareCount": 132300,
    "collectCount": 208014,
    "hashtags": [
      "burger",
      "hothoneychicken",
      "crispychicken",
      "food",
      "cooking"
    ],
    "music": {
      "id": "7688777177488558880",
      "title": "son original",
      "authorName": "Nada",
      "original": true
    },
    "coverUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/oEqCE0eEADEpLQAA5B0CfFh2YDmaaIdLRAtY7A~tplv-tiktokx-origin.image?dr=9636&x-expires=1793844000&x-signature=MY2R4xFIJxaVUEfJs%2BdozmwsGwg%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
    "isAd": false,
    "author": {
      "handle": "_nada_dl",
      "nickname": "Nada",
      "verified": false,
      "followerCount": 756600
    },
    "scrapedAt": "2026-11-02T20:00:00.000Z",
    "error": null
  }
]

Use cases

• Hashtag and trend research: see which videos TikTok shows for a hashtag right now, with their views, likes, comments, shares and saves, ready for a spreadsheet.
• Campaign and brand monitoring: follow your campaign hashtag and collect every listed video with its numbers and the creator's handle.
• Creator discovery: find the accounts posting under a niche hashtag and compare how their videos perform (handle, display name, verified badge and follower count only).
• Content and caption research: collect captions, hashtags used together, sounds and durations of the videos in a niche.
• AI agents and automations: a clean, typed dataset that an agent or a Make, Zapier or n8n flow can read directly, one row per video.

Input examples

The prefilled example input. It runs in seconds and returns a handful of results:

{
  "hashtags": [
    "cooking"
  ],
  "maxVideosPerHashtag": 10,
  "maxItems": 10
}

Field	Type	Required	Default	Description
hashtags	array	yes		TikTok hashtags, one per line (bulk paste works). Write them as cooking, #cooking or https://www.tiktok.com/tag/cooking; they are matched without the # sign and in lower case, and duplicates are loaded once. Up to 100 per run.
maxVideosPerHashtag	integer	no	50	How many videos to collect for each hashtag, in the order TikTok lists them on the hashtag page. The page is scrolled until this many are listed or TikTok shows no more. Up to 80 (TikTok usually stops showing more after about 85).
maxItems	integer	no		Stop after this many videos are in your dataset, across all hashtags. You pay per video, so this also caps the cost of a run. Leave empty to collect every hashtag in full.
maxRetries	integer	no	3	How many more times a hashtag page that shows no videos, or a video page that arrives without data, is loaded again, each time through a new proxy IP, before it gets a free error row.

How much does TikTok Hashtag Scraper, Video Stats and Engagement API cost?

This actor uses pay-per-event pricing: you pay only for results you get, plus a small fee per run. Higher Apify plans get a lower price per result.

Event	Free plan	Bronze plan	Silver plan	Gold plan
Video (per 1,000)	$2.70	$2.70	$2.50	$2.20
Actor start (per run)	$0.00005	$0.00005	$0.00005	$0.00005

1,000 results cost $2.7001 on the Bronze plan. In one run, 1,000 results cost $2.7001 on the Free plan, $2.7001 on the Bronze plan, $2.5001 on the Silver plan and $2.2001 on the Gold plan, including the actor start.

Video: One TikTok video row with data in your dataset. Hashtags that list no videos, videos whose page does not arrive, deleted videos and duplicates are free. Actor start: Charged once when a run starts (Apify counts one start per GB of memory). You can set a maximum cost per run in the run options; the actor stops cleanly when it is reached.

Schedule and monitor

Track a hashtag over time: save your hashtags as a task and schedule it daily or weekly. Each run adds a dataset of the videos TikTok lists under each hashtag at that moment, with their current views, likes, comments, shares and saves and a scrapedAt time, so you can see which videos rise and how a hashtag's top content changes.

Run TikTok Hashtag Scraper, Video Stats and Engagement API on a schedule to keep your data fresh and to monitor what changed since the last run:

1. Run the actor once with your input, then save that input as a task in Apify Console.
2. Open Schedules in Apify Console, click Create new, choose the task and set how often it runs with a cron expression, for example 0 6 * * 1 for every Monday at 06:00. Schedules support time zones and daylight saving time.
3. Every scheduled run writes a new dataset. Compare it with the previous run, or send it onward with a webhook or one of the integrations below.

Integrations and API

TikTok Hashtag Scraper, Video Stats and Engagement API runs on the Apify platform, so its results can go wherever Apify connects:

• API: start a run and read the results over HTTP from any language (examples below).
• Make, Zapier and n8n: Apify has official integrations for all three. Run the actor from a Make scenario, a Zap or an n8n workflow and pass each result to the next step, such as a spreadsheet, a CRM or a chat message.
• Webhooks: have Apify call your own URL when a run succeeds or fails, for example to load the new dataset into your system.
• Schedules: run it automatically at the times you choose (see Schedule and monitor above).
• Downloads: export any run's dataset as JSON, CSV, Excel, XML, HTML table, RSS or JSONL.

Run it with the API

One request starts a run and returns its dataset items, for runs that finish within 300 seconds. For bigger runs, start the run, then read its dataset when it finishes.

curl -X POST "https://api.apify.com/v2/actors/hhonlineventures~tiktok-hashtag-videos/run-sync-get-dataset-items" \
  -H "Authorization: Bearer <YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"hashtags": ["cooking"], "maxVideosPerHashtag": 10, "maxItems": 10}'

JavaScript, with npm install apify-client:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('hhonlineventures/tiktok-hashtag-videos').call({"hashtags": ["cooking"], "maxVideosPerHashtag": 10, "maxItems": 10});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python, with pip install apify-client:

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("hhonlineventures/tiktok-hashtag-videos").call(run_input={'hashtags': ['cooking'], 'maxVideosPerHashtag': 10, 'maxItems': 10})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

Your API token is in Apify Console under API & Integrations.

Use with AI agents (MCP)

AI agents can run TikTok Hashtag Scraper, Video Stats and Engagement API as a tool through the Apify MCP server (https://mcp.apify.com). The agent reads the input schema and the output fields above, fills in the input and gets the dataset back, with no glue code.

To give an agent exactly this actor, add the server to your MCP client with the actor in the tools parameter:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=hhonlineventures/tiktok-hashtag-videos"
    }
  }
}

On first connection your browser opens so you can sign in to Apify and approve access. A client that cannot do that can send an Authorization: Bearer <YOUR_APIFY_TOKEN> header instead, and a client that runs only local servers can start npx -y @apify/actors-mcp-server with APIFY_TOKEN set.

Then ask in plain language, for example:

Run TikTok Hashtag Scraper, Video Stats and Engagement API with this input: {"hashtags": ["cooking"], "maxVideosPerHashtag": 10, "maxItems": 10}. Show me the results as a table.

The server also has search-actors, fetch-actor-details and call-actor tools, which let an agent find this actor in Apify Store, read its details and run it. Agent runs are charged the same pay-per-event prices as any other run.

Limits

• You get the videos TikTok shows on the public hashtag page, in the order it shows them. TikTok decides which videos it lists and in what order; it is not a complete archive of every video ever posted with the hashtag.
• Up to 80 videos per hashtag. The page is scrolled until your number is listed or TikTok shows no more. In our tests TikTok usually stopped adding videos after about 85 per page load, and some hashtags list far fewer (one popular hashtag listed only 4).
• Sometimes TikTok answers with an empty page instead of the hashtag's videos. The actor then loads the hashtag again through a new proxy IP (3 more times by default); if no videos appear, the hashtag gets a free row with an error message.
• A listed video whose page does not arrive after its retries, or that was deleted, gets a free row and is replaced by the next listed video, so you still get your number when the page listed enough.
• Counts are what TikTok shows on each video's public page at the time of the run. TikTok rounds large numbers (for example 1.2M views arrive as 1200000).
• coverUrl is a signed TikTok image link that expires after a few days. Save the image yourself if you need it longer.
• A video listed under two of your hashtags is delivered once, under the first one, and charged once.
• Hashtags are read one after another, each in a real browser. In our tests one hashtag page load took about 25 to 40 seconds, about one minute per hashtag on average including reloads of empty pages; then its videos are fetched at about one per second.

What this actor is not

• Not a search tool: no keyword, sound or profile search. You give it hashtags.
• Not a downloader: no video or audio files and no download links, only a cover image link.
• Not a comment scraper: comment counts only, not the comments themselves.
• Not a trending list: it does not read TikTok's trending or Creative Center rankings; it reads the hashtags you enter.
• Not a profile scraper: for each creator it returns the handle, display name, verified badge and follower count, nothing else (no bio, avatar or contact details).

Search terms buyers use

• TikTok hashtag scraper
• TikTok hashtag videos
• TikTok hashtag analytics
• TikTok hashtag tracker
• TikTok hashtag API
• TikTok videos by hashtag
• TikTok tag scraper
• TikTok trend research
• TikTok hashtag views and likes
• TikTok hashtag monitoring

FAQ

What do I need to run it?

Only hashtags and an Apify account. No TikTok account, login, cookies or API key. Enter the hashtags one per line, or send them as the hashtags array through the API.

How do I write the hashtags?

Any of cooking, #cooking or https://www.tiktok.com/tag/cooking. They are matched in lower case without the #, so #Cooking and cooking are the same hashtag and it is loaded once. A hashtag has letters, digits and underscores only; an entry with spaces gets a free error row.

How many videos can I get per hashtag?

Set maxVideosPerHashtag (50 by default, up to 80). The actor scrolls the hashtag page until that many videos are listed or TikTok shows no more. TikTok's hashtag page usually stops adding videos after about 85, so deeper lists are not offered. Use maxItems to cap the whole run.

What am I charged for?

One video event per video row in your dataset, plus the actor start. Hashtags that list no videos, videos whose page does not arrive, deleted videos and duplicates are free.

Can I track a hashtag over time?

Yes. Save the input as a task and schedule it (for example every day). Each run adds a new dataset with the videos listed at that moment, their current counts and a scrapedAt time, so you can compare runs or send them to a spreadsheet.

Why does the order or the set of videos change between runs?

TikTok chooses which videos its hashtag page shows and in what order, and that changes over time. The actor returns what the page lists at the time of the run.

What happens if I set a maximum cost per run?

The actor loads only as many hashtags and videos as your limit pays for, then stops cleanly. Every video in your dataset was charged once; nothing else was.

Is it legal to collect this data?

The actor reads only public pages, the same ones anyone can open without logging in, and leaves out personal details such as bios and avatars. You are responsible for how you use the data and for following TikTok's terms and the laws that apply to you.