# TikTok Hashtag Scraper (clockworks/tiktok-hashtag-scraper) via StableApify

> TikTok Hashtag Scraper (clockworks/tiktok-hashtag-scraper) via StableApify is a paid API for AI agents from stableapify.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Scrapes TikTok videos matching one or more hashtags, returning video URLs, like counts, country of creation, and video/music metadata

## Facts

- Endpoint: POST https://stableapify.dev/api/actors/clockworks/tiktok-hashtag-scraper/call
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tiktok-hashtag-scraper-clockworks-tiktok-hashtag-scraper-via-15a765c3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CQBnPMaAJ27bVZiWbln01

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tiktok-hashtag-scraper-clockworks-tiktok-hashtag-scraper-via-15a765c3 -d '<json body>'
```

Example prompt: Can you scrape all TikTok videos posted under the hashtags #fitness and #workout and give me their video URLs, like counts, countries of creation, and music metadata?

## When to prefer this

Choose this endpoint when you need structured TikTok video data organized by hashtag — especially for trend research, campaign analysis, or influencer discovery. It is purpose-built for hashtag-based extraction rather than profile or comment scraping. Prefer this over generic web scrapers when you need TikTok-specific fields like music metadata and country of creation, and when you want pay-per-call pricing without managing your own Apify account.

## Known failure modes

- Invalid or non-existent hashtag returns empty results
- TikTok rate limiting or anti-scraping measures may cause incomplete data
- Actor run timeout for very large or trending hashtags with millions of videos
- Payment failure via x402 protocol prevents actor from starting
- Hashtag with no videos returns empty array

## How this service works

Start the "TikTok Hashtag Scraper" Apify actor (clockworks/tiktok-hashtag-scraper). Scrape TikTok hashtag data. Just add one or more hashtags and extract TikTok videos with that hashtag: URLs, likes, country of creation, video and music metada…

## Output

A structured list of TikTok video records matching the given hashtag(s), each containing the video URL, like count, country of creation, video metadata (e.g. description, duration, views), and music metadata (e.g. track name, author). Results are returned as the actor run output from Apify.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "hashtags",
    "resultsPerPage",
    "shouldDownloadVideos",
    "shouldDownloadCovers",
    "downloadSubtitlesOptions",
    "shouldDownloadSlideshowImages"
   ],
   "properties": {
    "hashtags": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "description": "Just add TikTok hashtags and the scraper will collect information about users, followers, likes, and more."
    },
    "resultsPerPage": {
     "type": "integer",
     "default": 100,
     "maximum": 9007199254740991,
     "minimum": 1,
     "description": "Maximum number of posts that will be scraped from every hashtag."
    },
    "shouldDownloadCovers": {
     "type": "boolean",
     "default": false,
     "description": "Tick to download TikTok video cover images (thumbnails). Note that this will increase time and costs needed to extract the data."
    },
    "shouldDownloadVideos": {
     "type": "boolean",
     "default": false,
     "description": "Tick to download TikTok videos. Note that this will increase time and costs needed to extract the data."
    },
    "videoKvStoreIdOrName": {
     "type": "string",
     "pattern": "^[a-zA-Z0-9-]+$",
     "description": "Name (or ID) of the Key Value Store where the videos and other media like thumbnails will be stored. Omit to store in the default one. Using this option will provide a named Key-Value store can help bypass data retention and store the content forever until the store is manually deleted. The Key-Value store's name can consist of a versatile combination of uppercase letters, lowercase letters, digits, or hyphens, all without any spaces."
    },
    "downloadSubtitlesOptions": {
     "enum": [
      "NEVER_DOWNLOAD_SUBTITLES",
      "DOWNLOAD_SUBTITLES",
      "DOWNLOAD_AND_TRANSCRIBE_VIDEOS_WITHOUT_SUBTITLES",
      "TRANSCRIBE_ALL_VIDEOS"
     ],
     "type": "string",
     "default": "NEVER_DOWNLOAD_SUBTITLES",
     "description": "Choose how to handle subtitles and audio transcription for input videos. Subtitles are provided by TikTok for some videos, and transcription means that this Actor will use speech-to-text AI to generate video transcript. Transcripts are charged as an extra event according to your plan."
    },
    "shouldDownloadSlideshowImages": {
     "type": "boolean",
     "default": false,
     "description": "Tick to download TikTok slideshow images. Note that this will increase costs and time re
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tiktok-hashtag-scraper-clockworks-tiktok-hashtag-scraper-via-15a765c3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stableapify.dev](https://www.zero.xyz/host/stableapify.dev/llms.txt)